Suport lingvistic

AstroWay construiește un API multilingv — interpretările textuale, rapoartele și horoscoapele zilnice sunt disponibile în limba utilizatorului. Lista publică include 20 de limbi, selectate pe baza cercetării cererii de pe piața astrologiei (volumul de căutări, acoperirea la competitori, potențialul de venit).

Sfat

Cum funcționează. Transmite limba în câmpul language din corpul cererii — sau prin ?lang=<code> în URL, ori prin antetul Accept-Language — către /v1/interpret/*, /v1/horoscope/*, /v1/reports/*. Dacă limba este activă, textul este returnat în ea (limbile în versiune Beta pot conține inexactități la termenii complecși, cu revenire automată la engleză). Dacă limba este inactivă, /horoscope/* și /reports/* (enum strict) răspund cu 400 INVALID_INPUT, în timp ce /interpret/* revine la engleză.

Stare actuală

Fiecare limbă are un Status al traducerii plus un Scor al cererii din planul de dezvoltare (prioritate, 48–95+).

#	Code	Limba	Status	Demand	Reports	Site
1	uk	ucraineană	✅ Source	—	✅	✅
2	en	engleză	✅ Reference	95+	✅	✅
3	de	germană	🚧 Auto	72	📋	✅
4	pl	poloneză	🚧 Auto	64	📋	✅
5	es	spaniolă	🚧 Auto	88	📋	✅
6	pt	portugheză	🚧 Auto	84	📋	✅
7	hi	hindi	🚧 Auto	81	📋	✅
8	fr	franceză	🚧 Auto	78	📋	✅
9	ko	coreeană	🚧 Auto	77	📋	✅
10	it	italiană	🚧 Auto	73	📋	✅
11	ja	japoneză	🚧 Auto	67	📋	✅
12	id	indoneziană	🚧 Auto	62	📋	✅
13	tr	turcă	🚧 Auto	60	📋	✅
14	nl	neerlandeză	🚧 Auto	58	📋	✅
15	cs	cehă	🚧 Auto	56	📋	✅
16	ro	română	🚧 Auto	54	📋	✅
17	vi	vietnameză	🚧 Auto	53	📋	✅
18	ar	arabă	🚧 Auto	52	📋	✅
19	el	greacă	🚧 Auto	50	📋	✅
20	hu	maghiară	🚧 Auto	48	📋	✅

Legendă:

• Status — ✅ Source / Reference = scris și întreținut de oameni (uk, en); 🚧 Auto = tradus automat în raport cu un glosar comun, rafinat în timp (deocamdată fără revizuire manuală a fiecărui șir, așa că termenii cu nuanțe pot suna brut; revenire automată la engleză pentru orice șir lipsă).
• Site — ✅ lansat (UI + documentație) · 📋 planificat.
• Reports — ✅ lansat · 📋 planificat.

Cum sunt produse traducerile

Ucraineana este limba sursă, iar engleza este referința întreținută — ambele scrise de oameni. Orice altă limbă este tradusă automat în raport cu un glosar astrologic comun (~800 de termeni) și rafinată în timp; deocamdată nu există o revizuire manuală a fiecărui șir, așa că tratează-le ca Beta la terminologia complexă, cu revenire automată la engleză acolo unde lipsește un șir. Interfața site-ului și documentația sunt acoperite astăzi în toate limbile listate; rapoartele PDF localizate sunt în prezent disponibile în ucraineană și engleză și se extind la restul în funcție de cerere.

Scorul cererii — cum este calculat

Un indice compozit construit din:

• volumul pe 12 luni din Google Trends pentru cuvintele cheie din astrologie în țara respectivă
• acoperirea de către primii 5 competitori (Co–Star, AstroSeek, Astro.com, Prokerala, DivineAPI)
• populația estimată × penetrarea estimată a aplicațiilor plătite
• diferența de venit per utilizator (ajustată la PPP)

Nu este o metrică exactă — este o prioritate ierarhizată care ajută la a decide obiectiv „ce urmează”, în loc de a ne baza pe impresii.

Cum să apelezi

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

Răspuns (exemplu pentru language=es):

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

Câmpul language din răspuns reflectă limba aplicată (util ca indicator UX). Starea calității traducerii se află în tabelul de mai sus; răspunsul API nu o returnează.

Dacă ai nevoie de o limbă care nu este în listă

Scrie-ne la hello@astroway.info cu dovezi ale cererii (utilizatori exemplificativi, volum estimat). Revizuim lista trimestrial — o limbă cu cerere externă reală poate fi adăugată ca Tier 4 (opt-in).

Unele limbi din lista scurtă sunt omise definitiv — da, fi, no, bg, sk, hr, zh-CN, fa, tl — din cauza unei piețe mici sau a lipsei unei tradiții astrologice. Sunt inactive: /horoscope/* și /reports/* returnează 400 INVALID_INPUT, în timp ce /interpret/* revine la engleză.

Conținut înrudit

• Precizia calculelor — calculele numerice sunt neutre din punct de vedere lingvistic, se localizează doar textul
• Rapoarte — rapoarte PDF multilingve
• Idempotență — reducerile din cache funcționează independent de lang