# Nyelvi támogatás

Az AstroWay egy **többnyelvű API**-t épít — a szöveges értelmezések, riportok és napi horoszkópok a felhasználó nyelvén érhetők el. A nyilvános lista 20 nyelvet tartalmaz, amelyeket az asztrológiai piac keresletének kutatása alapján választottunk ki (keresési volumen, versenytársak lefedettsége, bevételi potenciál).

<Aside type="tip">
**Hogyan működik.** Add meg a nyelvet a kérés törzsében a `language` mezőn keresztül — vagy `?lang=<code>` az URL-ben, vagy az `Accept-Language` fejlécben — a `/v1/interpret/*`, `/v1/horoscope/*`, `/v1/reports/*` végpontoknak. Ha a nyelv aktív, a szöveg azon a nyelven érkezik vissza (a Beta nyelvek pontatlanok lehetnek összetett kifejezéseknél, angol tartalék mellett). Ha a nyelv inaktív, a `/horoscope/*` és `/reports/*` (szigorú enum) `400 INVALID_INPUT` választ ad, míg az `/interpret/*` angolra esik vissza.
</Aside>

## Jelenlegi állapot

Minden nyelv hordoz egy fordítási **Státuszt** és egy ütemterv szerinti **Keresleti pontszámot** (prioritás, 48–95+).

| # | Code | Nyelv | Státusz | Kereslet | Riportok | Webhely |
|---|------|----------|--------|--------|---------|------|
| 1  | `uk` | Ukrán | ✅ Source | — | ✅ | ✅ |
| 2  | `en` | Angol | ✅ Reference | **95+** | ✅ | ✅ |
| 3  | `de` | Német | 🚧 Auto | 72 | 📋 | ✅ |
| 4  | `pl` | Lengyel | 🚧 Auto | 64 | 📋 | ✅ |
| 5  | `es` | Spanyol | 🚧 Auto | **88** | 📋 | ✅ |
| 6  | `pt` | Portugál | 🚧 Auto | **84** | 📋 | ✅ |
| 7  | `hi` | Hindi | 🚧 Auto | **81** | 📋 | ✅ |
| 8  | `fr` | Francia | 🚧 Auto | **78** | 📋 | ✅ |
| 9  | `ko` | Koreai | 🚧 Auto | **77** | 📋 | ✅ |
| 10 | `it` | Olasz | 🚧 Auto | 73 | 📋 | ✅ |
| 11 | `ja` | Japán | 🚧 Auto | 67 | 📋 | ✅ |
| 12 | `id` | Indonéz | 🚧 Auto | 62 | 📋 | ✅ |
| 13 | `tr` | Török | 🚧 Auto | 60 | 📋 | ✅ |
| 14 | `nl` | Holland | 🚧 Auto | 58 | 📋 | ✅ |
| 15 | `cs` | Cseh | 🚧 Auto | 56 | 📋 | ✅ |
| 16 | `ro` | Román | 🚧 Auto | 54 | 📋 | ✅ |
| 17 | `vi` | Vietnámi | 🚧 Auto | 53 | 📋 | ✅ |
| 18 | `ar` | Arab | 🚧 Auto | 52 | 📋 | ✅ |
| 19 | `el` | Görög | 🚧 Auto | 50 | 📋 | ✅ |
| 20 | `hu` | Magyar | 🚧 Auto | 48 | 📋 | ✅ |

**Jelmagyarázat:**
- **Státusz** — ✅ Source / Reference = ember által írt és karbantartott (uk, en); 🚧 Auto = közös szószedet alapján automatikusan lefordított, idővel finomított (még nincs soronkénti kézi ellenőrzés, ezért az árnyalt kifejezések nyersnek tűnhetnek; angol tartalék bármely hiányzó szövegre).
- **Webhely** — ✅ kiadva (UI + dokumentáció) · 📋 tervezett.
- **Riportok** — ✅ kiadva · 📋 tervezett.

## Hogyan készülnek a fordítások

Az ukrán a forrásnyelv, az angol pedig a karbantartott referencia — mindkettő ember által írt. Minden más nyelvet egy közös asztrológiai szószedet (~800 kifejezés) alapján automatikusan fordítunk, és idővel finomítunk; még nincs soronkénti kézi ellenőrzés, ezért összetett terminológia esetén Beta szintűként kezeld őket, angol tartalékkal ott, ahol egy szöveg hiányzik. A webhely felhasználói felülete és a dokumentáció ma már az összes felsorolt nyelvet lefedi; a lokalizált PDF riportok jelenleg ukránul és angolul jelennek meg, és kereslet szerint terjednek ki a többire.

## Keresleti pontszám — hogyan számítjuk

Egy összetett index, amely a következőkből épül fel:
- A Google Trends 12 havi volumene az ország asztrológiai kulcsszavain
- A top-5 versenytárs (Co–Star, AstroSeek, Astro.com, Prokerala, DivineAPI) lefedettsége
- Becsült népesség × becsült fizetős appok elterjedtsége
- Felhasználónkénti bevételi különbség (PPP-vel korrigálva)

Nem precíz mutató — egy **rangsorolt prioritás**, amely segít objektíven, nem benyomás alapján eldönteni, hogy „mi a következő".

## Hogyan hívd meg

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

Válasz (minta `language=es` esetén):

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

A válaszban a `language` mező visszhangozza az alkalmazott nyelvet (hasznos UX-jelzésként). A fordítás minőségi státusza a fenti táblázatban található; az API-válasz **nem** adja vissza.

## Ha olyan nyelvre van szükséged, ami nincs a listán

Írj a [hello@astroway.info](mailto:hello@astroway.info) címre keresleti bizonyítékkal (mintafelhasználók, várható volumen). A listát **negyedévente** vizsgáljuk felül — egy valós külső kereslettel rendelkező nyelv Tier 4-ként (opt-in) hozzáadható.

A rövidlistán szereplő egyes nyelvek **véglegesen kihagyásra** kerülnek — `da, fi, no, bg, sk, hr, zh-CN, fa, tl` — a kis piac vagy a hiányzó asztrológiai hagyomány miatt. Ezek inaktívak: a `/horoscope/*` és `/reports/*` `400 INVALID_INPUT` választ ad, míg az `/interpret/*` angolra esik vissza.

## Kapcsolódó

- [Számítási pontosság](/hu/accuracy/) — a numerikus számítások **nyelvfüggetlenek**, csak a szöveg van lokalizálva
- [Riportok](/hu/products/) — többnyelvű PDF riportok
- [Idempotencia](/hu/idempotency/) — a gyorsítótár-kedvezmények a `lang`-tól függetlenül működnek