# Prise en charge des langues

AstroWay construit une **API multilingue** — les interprétations textuelles, les rapports et les horoscopes quotidiens sont disponibles dans la langue de l'utilisateur. La liste publique compte 20 langues, sélectionnées à partir d'une étude de la demande sur le marché de l'astrologie (volume de recherche, couverture concurrentielle, potentiel de revenus).

<Aside type="tip">
**Comment ça marche.** Transmettez la langue via le champ `language` dans le corps de la requête — ou `?lang=<code>` dans l'URL, ou l'en-tête `Accept-Language` — à `/v1/interpret/*`, `/v1/horoscope/*`, `/v1/reports/*`. Si la langue est active, le texte revient dans cette langue (les langues Beta peuvent présenter des imprécisions sur les termes complexes, avec repli sur l'anglais). Si la langue est inactive, `/horoscope/*` et `/reports/*` (énumération stricte) répondent par `400 INVALID_INPUT`, tandis que `/interpret/*` se rabat sur l'anglais.
</Aside>

## Statut actuel

Chaque langue porte un **Statut** de traduction ainsi qu'un **Score de demande** issu de la feuille de route (priorité, 48–95+).

| # | Code | Langue | Statut | Demande | Rapports | Site |
|---|------|----------|--------|--------|---------|------|
| 1  | `uk` | Ukrainien | ✅ Source | — | ✅ | ✅ |
| 2  | `en` | Anglais | ✅ Reference | **95+** | ✅ | ✅ |
| 3  | `de` | Allemand | 🚧 Auto | 72 | 📋 | ✅ |
| 4  | `pl` | Polonais | 🚧 Auto | 64 | 📋 | ✅ |
| 5  | `es` | Espagnol | 🚧 Auto | **88** | 📋 | ✅ |
| 6  | `pt` | Portugais | 🚧 Auto | **84** | 📋 | ✅ |
| 7  | `hi` | Hindi | 🚧 Auto | **81** | 📋 | ✅ |
| 8  | `fr` | Français | 🚧 Auto | **78** | 📋 | ✅ |
| 9  | `ko` | Coréen | 🚧 Auto | **77** | 📋 | ✅ |
| 10 | `it` | Italien | 🚧 Auto | 73 | 📋 | ✅ |
| 11 | `ja` | Japonais | 🚧 Auto | 67 | 📋 | ✅ |
| 12 | `id` | Indonésien | 🚧 Auto | 62 | 📋 | ✅ |
| 13 | `tr` | Turc | 🚧 Auto | 60 | 📋 | ✅ |
| 14 | `nl` | Néerlandais | 🚧 Auto | 58 | 📋 | ✅ |
| 15 | `cs` | Tchèque | 🚧 Auto | 56 | 📋 | ✅ |
| 16 | `ro` | Roumain | 🚧 Auto | 54 | 📋 | ✅ |
| 17 | `vi` | Vietnamien | 🚧 Auto | 53 | 📋 | ✅ |
| 18 | `ar` | Arabe | 🚧 Auto | 52 | 📋 | ✅ |
| 19 | `el` | Grec | 🚧 Auto | 50 | 📋 | ✅ |
| 20 | `hu` | Hongrois | 🚧 Auto | 48 | 📋 | ✅ |

**Légende :**
- **Statut** — ✅ Source / Reference = rédigé et maintenu par des humains (uk, en) ; 🚧 Auto = traduit automatiquement par rapport à un glossaire commun, affiné au fil du temps (pas encore de relecture manuelle par chaîne, donc les termes nuancés peuvent paraître approximatifs ; repli sur l'anglais pour toute chaîne manquante).
- **Site** — ✅ livré (UI + docs) · 📋 planifié.
- **Rapports** — ✅ livré · 📋 planifié.

## Comment les traductions sont produites

L'ukrainien est la langue source et l'anglais la référence maintenue — les deux rédigés par des humains. Toute autre langue est traduite automatiquement par rapport à un glossaire d'astrologie commun (~800 termes) et affinée au fil du temps ; il n'y a pas encore de relecture manuelle par chaîne, alors traitez-les comme Beta sur la terminologie complexe, avec repli sur l'anglais là où une chaîne manque. L'UI du site et la documentation sont aujourd'hui couvertes dans toutes les langues listées ; les rapports PDF localisés sont actuellement livrés en ukrainien et en anglais et se déploient au reste selon la demande.

## Score de demande — comment il est calculé

Un indice composite construit à partir de :
- le volume Google Trends sur 12 mois pour les mots-clés d'astrologie dans le pays
- la couverture par les 5 principaux concurrents (Co–Star, AstroSeek, Astro.com, Prokerala, DivineAPI)
- la population estimée × le taux de pénétration estimé des applications payantes
- l'écart de revenu par utilisateur (ajusté à la PPA)

Ce n'est pas une mesure précise — une **priorité classée** qui aide à décider « quoi ensuite » de manière objective plutôt qu'à l'impression.

## Comment appeler

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

Réponse (exemple pour `language=es`) :

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

Le champ `language` dans la réponse renvoie la langue appliquée (pratique comme indicateur UX). Le statut de qualité de la traduction figure dans le tableau ci-dessus ; la réponse de l'API ne le renvoie **pas**.

## S'il vous faut une langue absente de la liste

Écrivez à [hello@astroway.info](mailto:hello@astroway.info) avec des preuves de demande (utilisateurs types, volume projeté). Nous révisons la liste **chaque trimestre** — une langue avec une demande externe réelle peut être ajoutée en tant que Tier 4 (opt-in).

Certaines langues de la liste restreinte sont **définitivement écartées** — `da, fi, no, bg, sk, hr, zh-CN, fa, tl` — en raison d'un marché restreint ou d'une tradition astrologique absente. Elles sont inactives : `/horoscope/*` et `/reports/*` renvoient `400 INVALID_INPUT`, tandis que `/interpret/*` se rabat sur l'anglais.

## Liens connexes

- [Précision des calculs](/fr/accuracy/) — les calculs numériques sont **indépendants de la langue**, seul le texte est localisé
- [Rapports](/fr/products/) — rapports PDF multilingues
- [Idempotence](/fr/idempotency/) — les remises de cache fonctionnent indépendamment de `lang`