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

<Aside type="tip">
**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.
</Aside>

## 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

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

Risposta (esempio per `language=es`):

```json
{
  "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](mailto: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](/it/accuracy/) — i calcoli numerici sono **indipendenti dalla lingua**, solo il testo viene localizzato
- [Report](/it/products/) — report PDF multilingue
- [Idempotenza](/it/idempotency/) — gli sconti di cache funzionano indipendentemente da `lang`