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).

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.

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

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):

{
  "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 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 — numerieke berekeningen zijn taalonafhankelijk, alleen de tekst wordt gelokaliseerd
• Rapporten — meertalige PDF-rapporten
• Idempotentie — cachekortingen werken onafhankelijk van lang