# Taalondersteuning

AstroWay bouwt een **meertalige API** — tekstinterpretaties, rapporten en dagelijkse horoscopen zijn beschikbaar in de taal van de gebruiker. De openbare lijst telt 20 talen, geselecteerd op basis van onderzoek naar de vraag in de astrologiemarkt (zoekvolume, dekking door concurrenten, omzetpotentieel).

<Aside type="tip">
**Hoe het werkt.** Geef de taal door via het veld `language` in de body van het verzoek — of `?lang=<code>` in de URL, of de header `Accept-Language` — naar `/v1/interpret/*`, `/v1/horoscope/*`, `/v1/reports/*`. Als de taal actief is, komt de tekst daarin terug (Beta-talen kunnen onnauwkeurigheden bevatten bij complexe termen, met terugval op het Engels). Als de taal inactief is, antwoorden `/horoscope/*` en `/reports/*` (strikte enum) met `400 INVALID_INPUT`, terwijl `/interpret/*` terugvalt op het Engels.
</Aside>

## Huidige status

Elke taal heeft een vertaal-**Status** plus een roadmap-**Demand score** (prioriteit, 48–95+).

| # | Code | Taal | Status | Demand | Reports | Site |
|---|------|----------|--------|--------|---------|------|
| 1  | `uk` | Oekraïens | ✅ Source | — | ✅ | ✅ |
| 2  | `en` | Engels | ✅ Reference | **95+** | ✅ | ✅ |
| 3  | `de` | Duits | 🚧 Auto | 72 | 📋 | ✅ |
| 4  | `pl` | Pools | 🚧 Auto | 64 | 📋 | ✅ |
| 5  | `es` | Spaans | 🚧 Auto | **88** | 📋 | ✅ |
| 6  | `pt` | Portugees | 🚧 Auto | **84** | 📋 | ✅ |
| 7  | `hi` | Hindi | 🚧 Auto | **81** | 📋 | ✅ |
| 8  | `fr` | Frans | 🚧 Auto | **78** | 📋 | ✅ |
| 9  | `ko` | Koreaans | 🚧 Auto | **77** | 📋 | ✅ |
| 10 | `it` | Italiaans | 🚧 Auto | 73 | 📋 | ✅ |
| 11 | `ja` | Japans | 🚧 Auto | 67 | 📋 | ✅ |
| 12 | `id` | Indonesisch | 🚧 Auto | 62 | 📋 | ✅ |
| 13 | `tr` | Turks | 🚧 Auto | 60 | 📋 | ✅ |
| 14 | `nl` | Nederlands | 🚧 Auto | 58 | 📋 | ✅ |
| 15 | `cs` | Tsjechisch | 🚧 Auto | 56 | 📋 | ✅ |
| 16 | `ro` | Roemeens | 🚧 Auto | 54 | 📋 | ✅ |
| 17 | `vi` | Vietnamees | 🚧 Auto | 53 | 📋 | ✅ |
| 18 | `ar` | Arabisch | 🚧 Auto | 52 | 📋 | ✅ |
| 19 | `el` | Grieks | 🚧 Auto | 50 | 📋 | ✅ |
| 20 | `hu` | Hongaars | 🚧 Auto | 48 | 📋 | ✅ |

**Legenda:**
- **Status** — ✅ Source / Reference = door mensen geschreven en onderhouden (uk, en); 🚧 Auto = automatisch vertaald aan de hand van een gedeelde woordenlijst, in de loop van de tijd verfijnd (nog geen handmatige beoordeling per string, dus genuanceerde termen kunnen ruw overkomen; terugval op het Engels bij elke ontbrekende string).
- **Site** — ✅ beschikbaar (UI + documentatie) · 📋 gepland.
- **Reports** — ✅ beschikbaar · 📋 gepland.

## Hoe vertalingen tot stand komen

Oekraïens is de brontaal en Engels is de onderhouden referentie — beide door mensen geschreven. Elke andere taal wordt automatisch vertaald aan de hand van een gedeelde astrologiewoordenlijst (~800 termen) en in de loop van de tijd verfijnd; er is nog geen handmatige beoordeling per string, dus behandel ze als Beta bij complexe terminologie, met terugval op het Engels waar een string ontbreekt. De UI van de site en de documentatie zijn vandaag in alle vermelde talen gedekt; gelokaliseerde PDF-rapporten zijn momenteel beschikbaar in het Oekraïens en Engels en worden voor de overige talen uitgerold op basis van de vraag.

## Demand Score — hoe deze wordt berekend

Een samengestelde index opgebouwd uit:
- Twaalfmaands volume van Google Trends op astrologietrefwoorden in het land
- Dekking door de top 5 concurrenten (Co–Star, AstroSeek, Astro.com, Prokerala, DivineAPI)
- Geschatte bevolking × geschatte penetratie van betaalde apps
- Verschil in omzet per gebruiker (gecorrigeerd voor koopkrachtpariteit)

Geen exacte maatstaf — een **gerangschikte prioriteit** die helpt om "wat is het volgende" objectief te beslissen in plaats van op gevoel.

## Hoe aan te roepen

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

Antwoord (voorbeeld voor `language=es`):

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

Het veld `language` in het antwoord herhaalt de toegepaste taal (handig als UX-indicator). De kwaliteitsstatus van de vertaling staat in de tabel hierboven; het API-antwoord geeft deze **niet** terug.

## Als je een taal nodig hebt die niet in de lijst staat

Stuur een e-mail naar [hello@astroway.info](mailto:hello@astroway.info) met bewijs van vraag (steekproef van gebruikers, verwacht volume). We herzien de lijst **per kwartaal** — een taal met echte externe vraag kan worden toegevoegd als Tier 4 (opt-in).

Sommige talen op de shortlist worden **permanent overgeslagen** — `da, fi, no, bg, sk, hr, zh-CN, fa, tl` — vanwege een kleine markt of het ontbreken van een astrologische traditie. Ze zijn inactief: `/horoscope/*` en `/reports/*` geven `400 INVALID_INPUT` terug, terwijl `/interpret/*` terugvalt op het Engels.

## Gerelateerd

- [Berekeningsnauwkeurigheid](/nl/accuracy/) — numerieke berekeningen zijn **taalonafhankelijk**, alleen de tekst wordt gelokaliseerd
- [Rapporten](/nl/products/) — meertalige PDF-rapporten
- [Idempotentie](/nl/idempotency/) — cachekortingen werken onafhankelijk van `lang`