Supporto linguistico

AstroWay sta costruendo un’API multilingue — interpretazioni testuali, report e oroscopi giornalieri sono disponibili nella lingua dell’utente. L’elenco pubblico è di 20 lingue, selezionate da una ricerca sulla domanda del mercato astrologico (volume di ricerca, copertura dei concorrenti, potenziale di ricavi).

Consiglio

Come funziona. Indica la lingua tramite il campo language nel corpo della richiesta — oppure ?lang=<code> nell’URL, o l’intestazione Accept-Language — verso /v1/interpret/*, /v1/horoscope/*, /v1/reports/*. Se la lingua è attiva, il testo viene restituito in essa (le lingue in Beta possono presentare imprecisioni sui termini complessi, con ripiego sull’inglese). Se la lingua è inattiva, /horoscope/* e /reports/* (enum rigido) rispondono con 400 INVALID_INPUT, mentre /interpret/* ripiega sull’inglese.

Stato attuale

Ogni lingua ha uno Status di traduzione più un Demand score di roadmap (priorità, 48–95+).

#	Code	Lingua	Status	Demand	Reports	Site
1	uk	Ucraino	✅ Source	—	✅	✅
2	en	Inglese	✅ Reference	95+	✅	✅
3	de	Tedesco	🚧 Auto	72	📋	✅
4	pl	Polacco	🚧 Auto	64	📋	✅
5	es	Spagnolo	🚧 Auto	88	📋	✅
6	pt	Portoghese	🚧 Auto	84	📋	✅
7	hi	Hindi	🚧 Auto	81	📋	✅
8	fr	Francese	🚧 Auto	78	📋	✅
9	ko	Coreano	🚧 Auto	77	📋	✅
10	it	Italiano	🚧 Auto	73	📋	✅
11	ja	Giapponese	🚧 Auto	67	📋	✅
12	id	Indonesiano	🚧 Auto	62	📋	✅
13	tr	Turco	🚧 Auto	60	📋	✅
14	nl	Olandese	🚧 Auto	58	📋	✅
15	cs	Ceco	🚧 Auto	56	📋	✅
16	ro	Rumeno	🚧 Auto	54	📋	✅
17	vi	Vietnamita	🚧 Auto	53	📋	✅
18	ar	Arabo	🚧 Auto	52	📋	✅
19	el	Greco	🚧 Auto	50	📋	✅
20	hu	Ungherese	🚧 Auto	48	📋	✅

Legenda:

• Status — ✅ Source / Reference = redatto e mantenuto da persone (uk, en); 🚧 Auto = tradotto automaticamente rispetto a un glossario condiviso, perfezionato nel tempo (ancora senza revisione manuale per singola stringa, quindi i termini più sfumati possono risultare grezzi; ripiego sull’inglese per qualsiasi stringa mancante).
• Site — ✅ disponibile (UI + documentazione) · 📋 pianificato.
• Reports — ✅ disponibile · 📋 pianificato.

Come vengono prodotte le traduzioni

L’ucraino è la lingua di origine e l’inglese è il riferimento mantenuto — entrambi redatti da persone. Ogni altra lingua è tradotta automaticamente rispetto a un glossario astrologico condiviso (~800 termini) e perfezionata nel tempo; non c’è ancora revisione manuale per singola stringa, quindi vanno considerate Beta sulla terminologia complessa, con ripiego sull’inglese dove una stringa è mancante. La UI del sito e la documentazione sono oggi coperte in tutte le lingue elencate; i report PDF localizzati sono attualmente disponibili in ucraino e inglese e verranno estesi alle altre in base alla domanda.

Demand Score — come si calcola

Un indice composito costruito a partire da:

• Volume a 12 mesi di Google Trends sulle parole chiave di astrologia nel Paese
• Copertura da parte dei primi 5 concorrenti (Co–Star, AstroSeek, Astro.com, Prokerala, DivineAPI)
• Popolazione stimata × penetrazione stimata delle app a pagamento
• Differenziale di ricavo per utente (rettificato per PPA)

Non è una metrica precisa — è una priorità ordinata che aiuta a decidere “cosa fare dopo” in modo oggettivo anziché a sensazione.

Come chiamare

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

Risposta (esempio per language=es):

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

Il campo language nella risposta riporta la lingua applicata (comodo come indicatore di UX). Lo stato di qualità della traduzione è nella tabella sopra; la risposta dell’API non lo restituisce.

Se ti serve una lingua non presente nell’elenco

Scrivi a hello@astroway.info con prove della domanda (campione di utenti, volume previsto). Rivediamo l’elenco trimestralmente — una lingua con una domanda esterna reale può essere aggiunta come Tier 4 (opt-in).

Alcune lingue della rosa ristretta sono escluse in modo permanente — da, fi, no, bg, sk, hr, zh-CN, fa, tl — a causa di un mercato ridotto o dell’assenza di tradizione astrologica. Sono inattive: /horoscope/* e /reports/* restituiscono 400 INVALID_INPUT, mentre /interpret/* ripiega sull’inglese.

Correlati

• Precisione dei calcoli — i calcoli numerici sono indipendenti dalla lingua, solo il testo viene localizzato
• Report — report PDF multilingue
• Idempotenza — gli sconti di cache funzionano indipendentemente da lang