# Obsługa języków

AstroWay buduje **wielojęzyczne API** — interpretacje tekstowe, raporty i dzienne horoskopy są dostępne w języku użytkownika. Publiczna lista obejmuje 20 języków, wybranych na podstawie badań popytu na rynku astrologicznym (wolumen wyszukiwań, pokrycie u konkurencji, potencjał przychodowy).

<Aside type="tip">
**Jak to działa.** Przekaż język w polu `language` w treści żądania — albo przez `?lang=<code>` w adresie URL, albo przez nagłówek `Accept-Language` — do `/v1/interpret/*`, `/v1/horoscope/*`, `/v1/reports/*`. Jeśli język jest aktywny, tekst zostaje zwrócony w nim (języki w wersji Beta mogą zawierać nieścisłości przy złożonych terminach, z awaryjnym przełączeniem na angielski). Jeśli język jest nieaktywny, `/horoscope/*` i `/reports/*` (ścisły enum) odpowiadają `400 INVALID_INPUT`, natomiast `/interpret/*` przełącza się awaryjnie na angielski.
</Aside>

## Aktualny status

Każdy język ma **Status** tłumaczenia oraz **Wskaźnik popytu** z planu rozwoju (priorytet, 48–95+).

| # | Code | Język | Status | Demand | Reports | Site |
|---|------|----------|--------|--------|---------|------|
| 1  | `uk` | ukraiński | ✅ Source | — | ✅ | ✅ |
| 2  | `en` | angielski | ✅ Reference | **95+** | ✅ | ✅ |
| 3  | `de` | niemiecki | 🚧 Auto | 72 | 📋 | ✅ |
| 4  | `pl` | polski | 🚧 Auto | 64 | 📋 | ✅ |
| 5  | `es` | hiszpański | 🚧 Auto | **88** | 📋 | ✅ |
| 6  | `pt` | portugalski | 🚧 Auto | **84** | 📋 | ✅ |
| 7  | `hi` | hindi | 🚧 Auto | **81** | 📋 | ✅ |
| 8  | `fr` | francuski | 🚧 Auto | **78** | 📋 | ✅ |
| 9  | `ko` | koreański | 🚧 Auto | **77** | 📋 | ✅ |
| 10 | `it` | włoski | 🚧 Auto | 73 | 📋 | ✅ |
| 11 | `ja` | japoński | 🚧 Auto | 67 | 📋 | ✅ |
| 12 | `id` | indonezyjski | 🚧 Auto | 62 | 📋 | ✅ |
| 13 | `tr` | turecki | 🚧 Auto | 60 | 📋 | ✅ |
| 14 | `nl` | niderlandzki | 🚧 Auto | 58 | 📋 | ✅ |
| 15 | `cs` | czeski | 🚧 Auto | 56 | 📋 | ✅ |
| 16 | `ro` | rumuński | 🚧 Auto | 54 | 📋 | ✅ |
| 17 | `vi` | wietnamski | 🚧 Auto | 53 | 📋 | ✅ |
| 18 | `ar` | arabski | 🚧 Auto | 52 | 📋 | ✅ |
| 19 | `el` | grecki | 🚧 Auto | 50 | 📋 | ✅ |
| 20 | `hu` | węgierski | 🚧 Auto | 48 | 📋 | ✅ |

**Legenda:**
- **Status** — ✅ Source / Reference = napisane i utrzymywane przez człowieka (uk, en); 🚧 Auto = tłumaczone automatycznie względem wspólnego glosariusza, doskonalone z czasem (brak jeszcze ręcznego przeglądu poszczególnych ciągów, więc niuansowe terminy mogą brzmieć surowo; awaryjne przełączenie na angielski przy każdym brakującym ciągu).
- **Site** — ✅ wdrożone (UI + dokumentacja) · 📋 planowane.
- **Reports** — ✅ wdrożone · 📋 planowane.

## Jak powstają tłumaczenia

Ukraiński jest językiem źródłowym, a angielski utrzymywanym punktem odniesienia — oba napisane przez człowieka. Każdy inny język jest tłumaczony automatycznie względem wspólnego glosariusza astrologicznego (~800 terminów) i doskonalony z czasem; nie ma jeszcze ręcznego przeglądu poszczególnych ciągów, więc traktuj je jako Beta przy złożonej terminologii, z awaryjnym przełączeniem na angielski tam, gdzie brakuje ciągu. Interfejs strony i dokumentacja są dziś objęte we wszystkich wymienionych językach; zlokalizowane raporty PDF są obecnie dostępne w języku ukraińskim i angielskim, a pozostałe są wdrażane w zależności od popytu.

## Wskaźnik popytu — jak jest obliczany

Indeks złożony zbudowany na podstawie:
- 12-miesięcznego wolumenu Google Trends dla słów kluczowych związanych z astrologią w danym kraju
- pokrycia przez 5 najlepszych konkurentów (Co–Star, AstroSeek, Astro.com, Prokerala, DivineAPI)
- szacowanej populacji × szacowanej penetracji płatnych aplikacji
- różnicy przychodu na użytkownika (skorygowanej o PPP)

To nie jest precyzyjna metryka — to **uszeregowany priorytet**, który pomaga obiektywnie decydować „co dalej”, zamiast kierować się wrażeniem.

## Jak wywołać

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

Odpowiedź (przykład dla `language=es`):

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

Pole `language` w odpowiedzi powtarza zastosowany język (przydatne jako wskaźnik UX). Status jakości tłumaczenia znajduje się w tabeli powyżej; odpowiedź API go **nie** zwraca.

## Jeśli potrzebujesz języka spoza listy

Napisz na [hello@astroway.info](mailto:hello@astroway.info), dołączając dowody popytu (przykładowi użytkownicy, prognozowany wolumen). Listę przeglądamy **kwartalnie** — język z rzeczywistym zewnętrznym popytem może zostać dodany jako Tier 4 (opcjonalnie).

Niektóre języki z krótkiej listy są **trwale pominięte** — `da, fi, no, bg, sk, hr, zh-CN, fa, tl` — z powodu małego rynku lub braku tradycji astrologicznej. Są nieaktywne: `/horoscope/*` i `/reports/*` zwracają `400 INVALID_INPUT`, natomiast `/interpret/*` przełącza się awaryjnie na angielski.

## Powiązane

- [Dokładność obliczeń](/pl/accuracy/) — obliczenia numeryczne są **niezależne od języka**, lokalizowany jest tylko tekst
- [Raporty](/pl/products/) — wielojęzyczne raporty PDF
- [Idempotencja](/pl/idempotency/) — zniżki z pamięci podręcznej działają niezależnie od `lang`