# Dukungan bahasa

AstroWay sedang membangun **API multibahasa** — interpretasi teks, laporan, dan horoskop harian tersedia dalam bahasa pengguna. Daftar publiknya berisi 20 bahasa, dipilih berdasarkan riset permintaan pasar astrologi (volume pencarian, cakupan kompetitor, potensi pendapatan).

<Aside type="tip">
**Cara kerjanya.** Sampaikan bahasa melalui field `language` di body permintaan — atau `?lang=<code>` di URL, atau header `Accept-Language` — ke `/v1/interpret/*`, `/v1/horoscope/*`, `/v1/reports/*`. Jika bahasa aktif, teks dikembalikan dalam bahasa tersebut (bahasa Beta mungkin kurang akurat pada istilah yang rumit, dengan fallback ke bahasa Inggris). Jika bahasa tidak aktif, `/horoscope/*` dan `/reports/*` (enum ketat) membalas dengan `400 INVALID_INPUT`, sementara `/interpret/*` jatuh kembali ke bahasa Inggris.
</Aside>

## Status saat ini

Setiap bahasa memiliki **Status** terjemahan ditambah **Demand score** roadmap (prioritas, 48–95+).

| # | Code | Language | Status | Demand | Reports | Site |
|---|------|----------|--------|--------|---------|------|
| 1  | `uk` | Bahasa Ukraina | ✅ Source | — | ✅ | ✅ |
| 2  | `en` | Bahasa Inggris | ✅ Reference | **95+** | ✅ | ✅ |
| 3  | `de` | Bahasa Jerman | 🚧 Auto | 72 | 📋 | ✅ |
| 4  | `pl` | Bahasa Polandia | 🚧 Auto | 64 | 📋 | ✅ |
| 5  | `es` | Bahasa Spanyol | 🚧 Auto | **88** | 📋 | ✅ |
| 6  | `pt` | Bahasa Portugis | 🚧 Auto | **84** | 📋 | ✅ |
| 7  | `hi` | Bahasa Hindi | 🚧 Auto | **81** | 📋 | ✅ |
| 8  | `fr` | Bahasa Prancis | 🚧 Auto | **78** | 📋 | ✅ |
| 9  | `ko` | Bahasa Korea | 🚧 Auto | **77** | 📋 | ✅ |
| 10 | `it` | Bahasa Italia | 🚧 Auto | 73 | 📋 | ✅ |
| 11 | `ja` | Bahasa Jepang | 🚧 Auto | 67 | 📋 | ✅ |
| 12 | `id` | Bahasa Indonesia | 🚧 Auto | 62 | 📋 | ✅ |
| 13 | `tr` | Bahasa Turki | 🚧 Auto | 60 | 📋 | ✅ |
| 14 | `nl` | Bahasa Belanda | 🚧 Auto | 58 | 📋 | ✅ |
| 15 | `cs` | Bahasa Ceko | 🚧 Auto | 56 | 📋 | ✅ |
| 16 | `ro` | Bahasa Rumania | 🚧 Auto | 54 | 📋 | ✅ |
| 17 | `vi` | Bahasa Vietnam | 🚧 Auto | 53 | 📋 | ✅ |
| 18 | `ar` | Bahasa Arab | 🚧 Auto | 52 | 📋 | ✅ |
| 19 | `el` | Bahasa Yunani | 🚧 Auto | 50 | 📋 | ✅ |
| 20 | `hu` | Bahasa Hungaria | 🚧 Auto | 48 | 📋 | ✅ |

**Keterangan:**
- **Status** — ✅ Source / Reference = ditulis dan dipelihara oleh manusia (uk, en); 🚧 Auto = diterjemahkan secara otomatis berdasarkan glosarium bersama, disempurnakan dari waktu ke waktu (belum ada peninjauan manual per-string, jadi istilah yang bernuansa bisa terasa kasar; fallback ke bahasa Inggris untuk string yang hilang).
- **Site** — ✅ tersedia (UI + dokumentasi) · 📋 direncanakan.
- **Reports** — ✅ tersedia · 📋 direncanakan.

## Bagaimana terjemahan dibuat

Bahasa Ukraina adalah bahasa sumber dan bahasa Inggris adalah referensi yang dipelihara — keduanya ditulis oleh manusia. Setiap bahasa lainnya diterjemahkan secara otomatis berdasarkan glosarium astrologi bersama (~800 istilah) dan disempurnakan dari waktu ke waktu; belum ada peninjauan manual per-string, jadi perlakukan sebagai Beta pada terminologi yang rumit, dengan fallback ke bahasa Inggris bila ada string yang hilang. UI situs dan dokumentasi telah mencakup semua bahasa yang terdaftar saat ini; laporan PDF yang dilokalkan saat ini tersedia dalam bahasa Ukraina dan Inggris, dan diperluas ke bahasa lainnya sesuai permintaan.

## Demand Score — bagaimana dihitung

Indeks gabungan yang dibangun dari:
- Volume Google Trends 12 bulan untuk kata kunci astrologi di negara terkait
- Cakupan oleh 5 kompetitor teratas (Co–Star, AstroSeek, Astro.com, Prokerala, DivineAPI)
- Estimasi populasi × estimasi penetrasi aplikasi berbayar
- Selisih pendapatan per pengguna (disesuaikan PPP)

Bukan metrik yang presisi — melainkan **prioritas berperingkat** yang membantu memutuskan "apa berikutnya" secara objektif alih-alih berdasarkan kesan.

## Cara memanggil

```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 }
    ]
  }'
```

Respons (contoh untuk `language=es`):

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

Field `language` dalam respons menggemakan bahasa yang diterapkan (berguna sebagai indikator UX). Status kualitas terjemahan ada di tabel di atas; respons API **tidak** mengembalikannya.

## Jika Anda membutuhkan bahasa yang tidak ada di daftar

Kirim email ke [hello@astroway.info](mailto:hello@astroway.info) disertai bukti permintaan (contoh pengguna, proyeksi volume). Kami meninjau daftar ini **setiap kuartal** — bahasa dengan permintaan eksternal yang nyata dapat ditambahkan sebagai Tier 4 (opt-in).

Beberapa bahasa dalam short-list **dilewati secara permanen** — `da, fi, no, bg, sk, hr, zh-CN, fa, tl` — karena pasar yang kecil atau tidak adanya tradisi astrologi. Bahasa-bahasa ini tidak aktif: `/horoscope/*` dan `/reports/*` mengembalikan `400 INVALID_INPUT`, sementara `/interpret/*` jatuh kembali ke bahasa Inggris.

## Terkait

- [Akurasi perhitungan](/id/accuracy/) — perhitungan numerik bersifat **netral-bahasa**, hanya teks yang dilokalkan
- [Laporan](/id/products/) — laporan PDF multibahasa
- [Idempotensi](/id/idempotency/) — diskon cache bekerja independen dari `lang`