# Dil desteği

AstroWay bir **çok dilli API** geliştiriyor — metin yorumları, raporlar ve günlük burç yorumları kullanıcının dilinde sunuluyor. Genel liste, astroloji pazarı talep araştırmasından (arama hacmi, rakip kapsamı, gelir potansiyeli) seçilen 20 dilden oluşuyor.

<Aside type="tip">
**Nasıl çalışır.** Dili istek gövdesindeki `language` alanı aracılığıyla — veya URL'deki `?lang=<code>` ile ya da `Accept-Language` başlığıyla — `/v1/interpret/*`, `/v1/horoscope/*`, `/v1/reports/*` uç noktalarına iletin. Dil aktifse, metin o dilde geri döner (Beta diller karmaşık terimlerde hatalar içerebilir, İngilizce yedekle birlikte). Dil pasifse, `/horoscope/*` ve `/reports/*` (katı enum) `400 INVALID_INPUT` yanıtı verir, `/interpret/*` ise İngilizceye geri döner.
</Aside>

## Mevcut durum

Her dil bir çeviri **Durumu** ile bir yol haritası **Talep puanı** (öncelik, 48–95+) taşır.

| # | Code | Dil | Durum | Talep | Raporlar | Site |
|---|------|----------|--------|--------|---------|------|
| 1  | `uk` | Ukraynaca | ✅ Source | — | ✅ | ✅ |
| 2  | `en` | İngilizce | ✅ Reference | **95+** | ✅ | ✅ |
| 3  | `de` | Almanca | 🚧 Auto | 72 | 📋 | ✅ |
| 4  | `pl` | Lehçe | 🚧 Auto | 64 | 📋 | ✅ |
| 5  | `es` | İspanyolca | 🚧 Auto | **88** | 📋 | ✅ |
| 6  | `pt` | Portekizce | 🚧 Auto | **84** | 📋 | ✅ |
| 7  | `hi` | Hintçe | 🚧 Auto | **81** | 📋 | ✅ |
| 8  | `fr` | Fransızca | 🚧 Auto | **78** | 📋 | ✅ |
| 9  | `ko` | Korece | 🚧 Auto | **77** | 📋 | ✅ |
| 10 | `it` | İtalyanca | 🚧 Auto | 73 | 📋 | ✅ |
| 11 | `ja` | Japonca | 🚧 Auto | 67 | 📋 | ✅ |
| 12 | `id` | Endonezce | 🚧 Auto | 62 | 📋 | ✅ |
| 13 | `tr` | Türkçe | 🚧 Auto | 60 | 📋 | ✅ |
| 14 | `nl` | Felemenkçe | 🚧 Auto | 58 | 📋 | ✅ |
| 15 | `cs` | Çekçe | 🚧 Auto | 56 | 📋 | ✅ |
| 16 | `ro` | Rumence | 🚧 Auto | 54 | 📋 | ✅ |
| 17 | `vi` | Vietnamca | 🚧 Auto | 53 | 📋 | ✅ |
| 18 | `ar` | Arapça | 🚧 Auto | 52 | 📋 | ✅ |
| 19 | `el` | Yunanca | 🚧 Auto | 50 | 📋 | ✅ |
| 20 | `hu` | Macarca | 🚧 Auto | 48 | 📋 | ✅ |

**Açıklama:**
- **Durum** — ✅ Source / Reference = insan tarafından yazılmış ve sürdürülmektedir (uk, en); 🚧 Auto = ortak bir sözlüğe göre otomatik çevrilmiş, zamanla iyileştirilmektedir (henüz dize başına manuel inceleme yok, bu nedenle ince terimler kaba okunabilir; eksik herhangi bir dize için İngilizce yedek).
- **Site** — ✅ yayında (UI + dokümantasyon) · 📋 planlanmış.
- **Raporlar** — ✅ yayında · 📋 planlanmış.

## Çeviriler nasıl üretilir

Ukraynaca kaynak dildir ve İngilizce sürdürülen referanstır — her ikisi de insan tarafından yazılmıştır. Diğer her dil, ortak bir astroloji sözlüğüne (~800 terim) göre otomatik olarak çevrilir ve zamanla iyileştirilir; henüz dize başına manuel inceleme yoktur, bu nedenle karmaşık terminolojide bunları Beta olarak değerlendirin, bir dize eksik olduğunda İngilizce yedekle birlikte. Site arayüzü ve dokümantasyon bugün listelenen tüm dilleri kapsar; yerelleştirilmiş PDF raporlar şu anda Ukraynaca ve İngilizce olarak sunulur ve talebe göre geri kalanlara açılır.

## Talep puanı — nasıl hesaplanır

Şunlardan oluşan bileşik bir endeks:
- Ülkedeki astroloji anahtar kelimelerinde 12 aylık Google Trends hacmi
- İlk 5 rakip (Co–Star, AstroSeek, Astro.com, Prokerala, DivineAPI) tarafından kapsama
- Tahmini nüfus × tahmini ücretli uygulama penetrasyonu
- Kullanıcı başına gelir farkı (PPP'ye göre düzeltilmiş)

Kesin bir metrik değil — "sırada ne var" sorusuna izlenimle değil nesnel olarak karar vermeye yardımcı olan **sıralanmış bir öncelik**.

## Nasıl çağrılır

```bash
curl -X POST https://api.astroway.info/v1/interpret/aspects \
  -H "X-Api-Key: aw_live_..." \
  -H "Content-Type: application/json" \
  -d '{
    "language": "es",
    "aspects": [
      { "body1": "Sun", "body2": "Moon", "type": "conjunction", "orb": 2.1 }
    ]
  }'
```

Yanıt (`language=es` için örnek):

```json
{
  "ok": true,
  "data": {
    "interpretation": "El aspecto Sol-Luna en conjunción simboliza...",
    "language": "es"
  }
}
```

Yanıttaki `language` alanı uygulanan dili yankılar (UX göstergesi olarak kullanışlıdır). Çeviri kalitesi durumu yukarıdaki tablodadır; API yanıtı bunu **döndürmez**.

## Listede olmayan bir dile ihtiyacınız varsa

Talep kanıtıyla (örnek kullanıcılar, öngörülen hacim) [hello@astroway.info](mailto:hello@astroway.info) adresine e-posta gönderin. Listeyi **üç ayda bir** gözden geçiriyoruz — gerçek harici talebi olan bir dil Tier 4 (opt-in) olarak eklenebilir.

Kısa listedeki bazı diller **kalıcı olarak atlanır** — `da, fi, no, bg, sk, hr, zh-CN, fa, tl` — küçük pazar veya astroloji geleneğinin yokluğu nedeniyle. Bunlar pasiftir: `/horoscope/*` ve `/reports/*` `400 INVALID_INPUT` döndürür, `/interpret/*` ise İngilizceye geri döner.

## İlgili

- [Hesaplama doğruluğu](/tr/accuracy/) — sayısal hesaplamalar **dilden bağımsızdır**, yalnızca metin yerelleştirilir
- [Raporlar](/tr/products/) — çok dilli PDF raporlar
- [Idempotency](/tr/idempotency/) — önbellek indirimleri `lang`'dan bağımsız çalışır