# Podpora jazyků

AstroWay buduje **vícejazyčné API** — textové interpretace, reporty a denní horoskopy jsou dostupné v jazyce uživatele. Veřejný seznam zahrnuje 20 jazyků, vybraných na základě průzkumu poptávky na astrologickém trhu (objem vyhledávání, pokrytí u konkurence, příjmový potenciál).

<Aside type="tip">
**Jak to funguje.** Předej jazyk v poli `language` v těle požadavku — nebo přes `?lang=<code>` v URL, nebo přes hlavičku `Accept-Language` — na `/v1/interpret/*`, `/v1/horoscope/*`, `/v1/reports/*`. Pokud je jazyk aktivní, text se vrátí v něm (jazyky ve fázi Beta mohou obsahovat nepřesnosti u složitých termínů, se záložním přepnutím na angličtinu). Pokud je jazyk neaktivní, `/horoscope/*` a `/reports/*` (striktní enum) odpovídají `400 INVALID_INPUT`, zatímco `/interpret/*` se záložně přepne na angličtinu.
</Aside>

## Současný stav

Každý jazyk nese **Stav** překladu plus **Skóre poptávky** z plánu rozvoje (priorita, 48–95+).

| # | Code | Jazyk | Status | Demand | Reports | Site |
|---|------|-------|--------|--------|---------|------|
| 1  | `uk` | ukrajinština | ✅ Source | — | ✅ | ✅ |
| 2  | `en` | angličtina | ✅ Reference | **95+** | ✅ | ✅ |
| 3  | `de` | němčina | 🚧 Auto | 72 | 📋 | ✅ |
| 4  | `pl` | polština | 🚧 Auto | 64 | 📋 | ✅ |
| 5  | `es` | španělština | 🚧 Auto | **88** | 📋 | ✅ |
| 6  | `pt` | portugalština | 🚧 Auto | **84** | 📋 | ✅ |
| 7  | `hi` | hindština | 🚧 Auto | **81** | 📋 | ✅ |
| 8  | `fr` | francouzština | 🚧 Auto | **78** | 📋 | ✅ |
| 9  | `ko` | korejština | 🚧 Auto | **77** | 📋 | ✅ |
| 10 | `it` | italština | 🚧 Auto | 73 | 📋 | ✅ |
| 11 | `ja` | japonština | 🚧 Auto | 67 | 📋 | ✅ |
| 12 | `id` | indonéština | 🚧 Auto | 62 | 📋 | ✅ |
| 13 | `tr` | turečtina | 🚧 Auto | 60 | 📋 | ✅ |
| 14 | `nl` | nizozemština | 🚧 Auto | 58 | 📋 | ✅ |
| 15 | `cs` | čeština | 🚧 Auto | 56 | 📋 | ✅ |
| 16 | `ro` | rumunština | 🚧 Auto | 54 | 📋 | ✅ |
| 17 | `vi` | vietnamština | 🚧 Auto | 53 | 📋 | ✅ |
| 18 | `ar` | arabština | 🚧 Auto | 52 | 📋 | ✅ |
| 19 | `el` | řečtina | 🚧 Auto | 50 | 📋 | ✅ |
| 20 | `hu` | maďarština | 🚧 Auto | 48 | 📋 | ✅ |

**Legenda:**
- **Status** — ✅ Source / Reference = napsáno a udržováno člověkem (uk, en); 🚧 Auto = automaticky přeloženo vůči sdílenému glosáři, postupně vylepšováno (zatím bez ruční kontroly jednotlivých řetězců, takže jemné termíny mohou znít neuhlazeně; záložní přepnutí na angličtinu u každého chybějícího řetězce).
- **Site** — ✅ nasazeno (UI + dokumentace) · 📋 plánováno.
- **Reports** — ✅ nasazeno · 📋 plánováno.

## Jak vznikají překlady

Ukrajinština je zdrojový jazyk a angličtina udržovaný referenční bod — oba napsané člověkem. Každý další jazyk je automaticky přeložen vůči sdílenému astrologickému glosáři (~800 termínů) a postupně vylepšován; zatím není ruční kontrola jednotlivých řetězců, takže je u složité terminologie ber jako Beta, se záložním přepnutím na angličtinu tam, kde řetězec chybí. UI webu a dokumentace jsou dnes pokryty ve všech uvedených jazycích; lokalizované PDF reporty jsou aktuálně dostupné v ukrajinštině a angličtině a postupně se rozšiřují na ostatní podle poptávky.

## Skóre poptávky — jak se počítá

Kompozitní index sestavený z:
- 12měsíčního objemu Google Trends pro astrologická klíčová slova v dané zemi
- pokrytí u 5 největších konkurentů (Co–Star, AstroSeek, Astro.com, Prokerala, DivineAPI)
- odhadovaného počtu obyvatel × odhadovaného podílu placených aplikací
- rozdílu v příjmu na uživatele (upraveno podle PPP)

Není to přesné měřítko — je to **seřazená priorita**, která pomáhá objektivně rozhodovat „co dál“, místo aby se vycházelo z dojmu.

## Jak volat

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

Odpověď (příklad pro `language=es`):

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

Pole `language` v odpovědi opakuje použitý jazyk (užitečné jako UX indikátor). Stav kvality překladu je v tabulce výše; odpověď API jej **nevrací**.

## Pokud potřebujete jazyk, který není v seznamu

Napište na [hello@astroway.info](mailto:hello@astroway.info) s důkazy o poptávce (ukázkoví uživatelé, odhadovaný objem). Seznam přezkoumáváme **každé čtvrtletí** — jazyk se skutečnou externí poptávkou může být přidán jako Tier 4 (opt-in).

Některé jazyky ze zkráceného seznamu jsou **trvale vynechány** — `da, fi, no, bg, sk, hr, zh-CN, fa, tl` — kvůli malému trhu nebo absenci astrologické tradice. Jsou neaktivní: `/horoscope/*` a `/reports/*` vracejí `400 INVALID_INPUT`, zatímco `/interpret/*` se záložně přepne na angličtinu.

## Související

- [Přesnost výpočtů](/cs/accuracy/) — numerické výpočty jsou **jazykově neutrální**, lokalizuje se pouze text
- [Reporty](/cs/products/) — vícejazyčné PDF reporty
- [Idempotence](/cs/idempotency/) — slevy z mezipaměti fungují nezávisle na `lang`