# Suport lingvistic

AstroWay construiește un **API multilingv** — interpretările textuale, rapoartele și horoscoapele zilnice sunt disponibile în limba utilizatorului. Lista publică include 20 de limbi, selectate pe baza cercetării cererii de pe piața astrologiei (volumul de căutări, acoperirea la competitori, potențialul de venit).

<Aside type="tip">
**Cum funcționează.** Transmite limba în câmpul `language` din corpul cererii — sau prin `?lang=<code>` în URL, ori prin antetul `Accept-Language` — către `/v1/interpret/*`, `/v1/horoscope/*`, `/v1/reports/*`. Dacă limba este activă, textul este returnat în ea (limbile în versiune Beta pot conține inexactități la termenii complecși, cu revenire automată la engleză). Dacă limba este inactivă, `/horoscope/*` și `/reports/*` (enum strict) răspund cu `400 INVALID_INPUT`, în timp ce `/interpret/*` revine la engleză.
</Aside>

## Stare actuală

Fiecare limbă are un **Status** al traducerii plus un **Scor al cererii** din planul de dezvoltare (prioritate, 48–95+).

| # | Code | Limba | Status | Demand | Reports | Site |
|---|------|-------|--------|--------|---------|------|
| 1  | `uk` | ucraineană | ✅ Source | — | ✅ | ✅ |
| 2  | `en` | engleză | ✅ Reference | **95+** | ✅ | ✅ |
| 3  | `de` | germană | 🚧 Auto | 72 | 📋 | ✅ |
| 4  | `pl` | poloneză | 🚧 Auto | 64 | 📋 | ✅ |
| 5  | `es` | spaniolă | 🚧 Auto | **88** | 📋 | ✅ |
| 6  | `pt` | portugheză | 🚧 Auto | **84** | 📋 | ✅ |
| 7  | `hi` | hindi | 🚧 Auto | **81** | 📋 | ✅ |
| 8  | `fr` | franceză | 🚧 Auto | **78** | 📋 | ✅ |
| 9  | `ko` | coreeană | 🚧 Auto | **77** | 📋 | ✅ |
| 10 | `it` | italiană | 🚧 Auto | 73 | 📋 | ✅ |
| 11 | `ja` | japoneză | 🚧 Auto | 67 | 📋 | ✅ |
| 12 | `id` | indoneziană | 🚧 Auto | 62 | 📋 | ✅ |
| 13 | `tr` | turcă | 🚧 Auto | 60 | 📋 | ✅ |
| 14 | `nl` | neerlandeză | 🚧 Auto | 58 | 📋 | ✅ |
| 15 | `cs` | cehă | 🚧 Auto | 56 | 📋 | ✅ |
| 16 | `ro` | română | 🚧 Auto | 54 | 📋 | ✅ |
| 17 | `vi` | vietnameză | 🚧 Auto | 53 | 📋 | ✅ |
| 18 | `ar` | arabă | 🚧 Auto | 52 | 📋 | ✅ |
| 19 | `el` | greacă | 🚧 Auto | 50 | 📋 | ✅ |
| 20 | `hu` | maghiară | 🚧 Auto | 48 | 📋 | ✅ |

**Legendă:**
- **Status** — ✅ Source / Reference = scris și întreținut de oameni (uk, en); 🚧 Auto = tradus automat în raport cu un glosar comun, rafinat în timp (deocamdată fără revizuire manuală a fiecărui șir, așa că termenii cu nuanțe pot suna brut; revenire automată la engleză pentru orice șir lipsă).
- **Site** — ✅ lansat (UI + documentație) · 📋 planificat.
- **Reports** — ✅ lansat · 📋 planificat.

## Cum sunt produse traducerile

Ucraineana este limba sursă, iar engleza este referința întreținută — ambele scrise de oameni. Orice altă limbă este tradusă automat în raport cu un glosar astrologic comun (~800 de termeni) și rafinată în timp; deocamdată nu există o revizuire manuală a fiecărui șir, așa că tratează-le ca Beta la terminologia complexă, cu revenire automată la engleză acolo unde lipsește un șir. Interfața site-ului și documentația sunt acoperite astăzi în toate limbile listate; rapoartele PDF localizate sunt în prezent disponibile în ucraineană și engleză și se extind la restul în funcție de cerere.

## Scorul cererii — cum este calculat

Un indice compozit construit din:
- volumul pe 12 luni din Google Trends pentru cuvintele cheie din astrologie în țara respectivă
- acoperirea de către primii 5 competitori (Co–Star, AstroSeek, Astro.com, Prokerala, DivineAPI)
- populația estimată × penetrarea estimată a aplicațiilor plătite
- diferența de venit per utilizator (ajustată la PPP)

Nu este o metrică exactă — este o **prioritate ierarhizată** care ajută la a decide obiectiv „ce urmează”, în loc de a ne baza pe impresii.

## Cum să apelezi

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

Răspuns (exemplu pentru `language=es`):

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

Câmpul `language` din răspuns reflectă limba aplicată (util ca indicator UX). Starea calității traducerii se află în tabelul de mai sus; răspunsul API **nu** o returnează.

## Dacă ai nevoie de o limbă care nu este în listă

Scrie-ne la [hello@astroway.info](mailto:hello@astroway.info) cu dovezi ale cererii (utilizatori exemplificativi, volum estimat). Revizuim lista **trimestrial** — o limbă cu cerere externă reală poate fi adăugată ca Tier 4 (opt-in).

Unele limbi din lista scurtă sunt **omise definitiv** — `da, fi, no, bg, sk, hr, zh-CN, fa, tl` — din cauza unei piețe mici sau a lipsei unei tradiții astrologice. Sunt inactive: `/horoscope/*` și `/reports/*` returnează `400 INVALID_INPUT`, în timp ce `/interpret/*` revine la engleză.

## Conținut înrudit

- [Precizia calculelor](/ro/accuracy/) — calculele numerice sunt **neutre din punct de vedere lingvistic**, se localizează doar textul
- [Rapoarte](/ro/products/) — rapoarte PDF multilingve
- [Idempotență](/ro/idempotency/) — reducerile din cache funcționează independent de `lang`