# Astrolojik uygulamalar

AstroWay API'sini kullanarak Co-Star, Sanctuary, The Pattern, Chani ya da Costar Compat benzeri bir astro uygulaması mı geliştiriyorsun? AstroWay API, Solar Fire ($495) lisansı almak ya da kendi efemeris motorunu yazmak zorunluluğunu ortadan kaldırıyor: {siteMeta.endpoints} endpoint (doğum haritası, senkroni, transitler, Human Design, AI yorumlamaları), OpenAPI 3.1 ile tiplemeli istemciler oluşturmak için (TS / Python SDK roadmap'te), Swiss Ephemeris hassasiyeti — Astrodienst ve Kepler'de kullanılanla aynı motor.

## Tipik Mimarisi

```
Kullanıcı (tarayıcı / mobil)
     ↓
Senin arka uç (Node.js / Python / PHP)
     ↓ HTTPS + X-Api-Key
api.astroway.info/v1/*
     ↓
JSON yanıtı → UI'n içinde render et
```

<Aside type="caution">
API anahtarını asla frontend koduna koyma. AstroWay API çağrıları senin arka uç ya da sunucu fonksiyonları (Next.js API rotaları, Vercel Functions, AWS Lambda) üzerinden yapılmalıdır.
</Aside>

## Astro uygulaması için temel endpointler

### MVP (Minimum Ürün)

| Endpoint | Krediler | Ne için |
|---|---|---|
| `/v1/chart` | 20 | Doğum haritası oluşturma |
| `/v1/synastry` | 50 | İki kişinin uyumu |
| `/v1/horoscope/daily` | 20 | Günlük burç yorumu |

Üç endpoint ile doğum haritası, uyum ve günlük içerik sunan çalışan bir ürüne sahip olabilirsin.

### Gelişmiş Ürün

| Endpoint | Krediler | Ne için |
|---|---|---|
| `/v1/transits` | 50 | Doğum haritasına şu anki transitler |
| `/v1/solar-return` | 50 | Yıllık harita (Solar) |
| `/v1/progressions` | 50 | İkincil ilerlemeler |
| `/v1/interpret/natal` | 50 | Doğum haritasının AI yorumlaması |
| `/v1/transit-calendar` | 100 | Transit olayları takvimi |
| `/v1/human-design` | 50 | HD haritası |

### Premium Fonksiyonlar

| Endpoint | Krediler | Ne için |
|---|---|---|
| `/v1/rectification` | 500 | Doğum zamanı düzeltme |
| `/v1/acg` | 50 | Astro coğrafya (nerede yaşamak daha iyi) |
| `/v1/forecast-calendar` | 100 | Yıllık tahmin-heatmap |
| `/v1/group-synastry` | 100 | Grup uyumu |

## Bütçe Tahmini

### Senaryo: 100 DAU (günlük aktif kullanıcı)

Ortalama kullanıcının günde 3 işlem yaptığını varsayıyoruz:

| İşlem | Endpoint | Krediler | Günde istek | Günde kredi |
|---|---|---|---|---|
| Harita görüntüleme | `/v1/chart` | 20 | 100 | 2 000 |
| Günlük burç yorumu | `/v1/horoscope/daily` | 20 | 100 | 2 000 |
| Uyum | `/v1/synastry` | 50 | 30 | 1 500 |
| **Toplam** | | | **230** | **5 500/gün** |

**~165 000 kredi/ay** (5 500 × 30) → **Starter ($19/ay, 200 000 kredi)** planıyla %21 fazla kapasite ya da **Indie ($5/ay, 50 000 kredi)** planıyla 110K ek kredi için ~$5 overage ödemesi.

### Senaryo: 20 DAU ile MVP

| İşlem | Günde kredi |
|---|---|
| 20 harita | 400 |
| 20 günlük yorum | 400 |
| 5 senkroni | 250 |
| **Toplam** | **1 050/gün** |

**~31 500 kredi/ay** → **Indie ($5/ay, 50 000 kredi)** planı.

## İpuçları

- **Doğum haritalarını önbelleğe al** — giriş değişmez (doğum tarihi değişmez), bu yüzden sonucu kendi veritabanında sonsuza kadar önbelleğe alabilirsin
- **Günlük burç yorumlarını önbelleğe al** — günlük burç yorumu aynı burçtaki tüm insanlar için aynıdır, bir kez oluştur ve dağıt
- **Sandbox anahtarları** (`aw_test_*`) — geliştirme için, kredi harcamaz
- **OpenAPI 3.1 ile Codegen** — `/v1/openapi.json` dosyasını `openapi-typescript` ya da `openapi-python-client` içine at ve tiplemeli istemciyi (hazır SDK'lar roadmap'te) al

<CardGrid>
  <LinkCard title="Hızlı Başlangıç →" href="/getting-started/" description="İlk isteği 5 dakikada yap" />
  <LinkCard title="Doğum Haritası API" href="/products/birth-chart-api/" description="Doğum haritası hakkında detaylar" />
  <LinkCard title="Fiyatlandırma" href="/pricing/" description="Ücretsizden Enterprise'a kadar" />
</CardGrid>