# Підтримка мов

AstroWay будує **multilingual API** — текстові інтерпретації, репорти і daily horoscope доступні мовою користувача. Публічний список — 20 мов, відібраних за попитом astrology-ринку (search volume, competitor coverage, revenue potential).

<Aside type="tip">
**Як це працює.** Передай мову через поле `language` у тілі запиту — або `?lang=<code>` у URL, або заголовок `Accept-Language` — до `/v1/interpret/*`, `/v1/horoscope/*`, `/v1/reports/*`. Якщо мова активна, текст повертається нею (Beta-мови можуть мати неточності у складних термінах, з fallback на English). Якщо мова неактивна — `/horoscope/*` і `/reports/*` (суворий enum) відповідають `400 INVALID_INPUT`, а `/interpret/*` тихо відкочуються на English.
</Aside>

## Поточний статус

Кожна мова має **Статус** перекладу плюс roadmap-**Demand score** (пріоритет, 48–95+).

| # | Code | Мова | Статус | Demand | Reports | Site |
|---|------|------|--------|--------|---------|------|
| 1  | `uk` | Українська | ✅ Source | — | ✅ | ✅ |
| 2  | `en` | English | ✅ Reference | **95+** | ✅ | ✅ |
| 3  | `de` | Deutsch | 🚧 Auto | 72 | 📋 | ✅ |
| 4  | `pl` | Polski | 🚧 Auto | 64 | 📋 | ✅ |
| 5  | `es` | Español | 🚧 Auto | **88** | 📋 | ✅ |
| 6  | `pt` | Português | 🚧 Auto | **84** | 📋 | ✅ |
| 7  | `hi` | हिन्दी | 🚧 Auto | **81** | 📋 | ✅ |
| 8  | `fr` | Français | 🚧 Auto | **78** | 📋 | ✅ |
| 9  | `ko` | 한국어 | 🚧 Auto | **77** | 📋 | ✅ |
| 10 | `it` | Italiano | 🚧 Auto | 73 | 📋 | ✅ |
| 11 | `ja` | 日本語 | 🚧 Auto | 67 | 📋 | ✅ |
| 12 | `id` | Bahasa Indonesia | 🚧 Auto | 62 | 📋 | ✅ |
| 13 | `tr` | Türkçe | 🚧 Auto | 60 | 📋 | ✅ |
| 14 | `nl` | Nederlands | 🚧 Auto | 58 | 📋 | ✅ |
| 15 | `cs` | Čeština | 🚧 Auto | 56 | 📋 | ✅ |
| 16 | `ro` | Română | 🚧 Auto | 54 | 📋 | ✅ |
| 17 | `vi` | Tiếng Việt | 🚧 Auto | 53 | 📋 | ✅ |
| 18 | `ar` | العربية | 🚧 Auto | 52 | 📋 | ✅ |
| 19 | `el` | Ελληνικά | 🚧 Auto | 50 | 📋 | ✅ |
| 20 | `hu` | Magyar | 🚧 Auto | 48 | 📋 | ✅ |

**Легенда:**
- **Статус** — ✅ Source / Reference = створено й підтримується людьми (uk, en); 🚧 Auto = автоматичний переклад за спільним глосарієм, доопрацьовується (поки без ручного review по рядках, тож складні терміни можуть звучати грубо; English fallback на відсутній рядок).
- **Site** — ✅ розгорнуто (UI + доки) · 📋 заплановано.
- **Reports** — ✅ розгорнуто · 📋 заплановано.

## Як виробляються переклади

Українська — мова-джерело, English — підтримувана референсна; обидві створені людьми. Кожна інша мова перекладається автоматично за спільним астрологічним глосарієм (~800 термінів) і доопрацьовується з часом; поки немає ручного review по рядках, тож сприймайте їх як Beta на складній термінології, з English fallback там, де рядок відсутній. UI сайту й документація покриті всіма переліченими мовами вже сьогодні; локалізовані PDF-репорти наразі виходять українською та англійською й розгортаються на решту за попитом.

## Demand Score — як рахується

Композитний індекс з:
- Google Trends 12-month volume на ключові слова astrology у країні
- Доступність у топ-5 конкурентів (Co–Star, AstroSeek, Astro.com, Prokerala, DivineAPI)
- Estimated population × estimated paid-app penetration
- Revenue-per-user delta (PPP-adjusted)

Не точна метрика, а **ranked priority** — нам важливо вирішувати "що наступне" обʼєктивно, а не за враженням.

## Як викликати

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

Reply (приклад для `lang=es`):

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

Поле `language` у відповіді повторює застосовану мову (зручно як UX-індикатор). Статус за мовою — у таблиці вище; у відповіді API він **не** повертається.

## Якщо потрібна мова не в списку

Напиши на [hello@astroway.info](mailto:hello@astroway.info) з підтвердженням попиту (приклади користувачів, потенційний обсяг). Ми переглядаємо список **щоквартально** — мова з реальним зовнішнім попитом може бути додана у Tier 4 (opt-in).

Деякі мови у короткому списку **скіпнуто назавжди** — `da, fi, no, bg, sk, hr, zh-CN, fa, tl` — через малий ринок або відсутність astrology-traditions. Вони неактивні: `/horoscope/*` та `/reports/*` дадуть `400 INVALID_INPUT`, а `/interpret/*` відкотяться на English.

## Пов'язане

- [Точність розрахунків](/accuracy/) — числові розрахунки **мова-нейтральні**, локалізується тільки текст
- [Reports](/products/) — multilingual PDF-репорти
- [Idempotency](/idempotency/) — кеш-знижки працюють незалежно від `lang`