# Compatibilidad de idiomas

AstroWay está construyendo una **API multilingüe** — las interpretaciones de texto, los informes y los horóscopos diarios están disponibles en el idioma del usuario. La lista pública es de 20 idiomas, seleccionados a partir de un estudio de la demanda del mercado astrológico (volumen de búsqueda, cobertura de la competencia, potencial de ingresos).

<Aside type="tip">
**Cómo funciona.** Pasa el idioma mediante el campo `language` en el cuerpo de la solicitud — o `?lang=<code>` en la URL, o la cabecera `Accept-Language` — a `/v1/interpret/*`, `/v1/horoscope/*`, `/v1/reports/*`. Si el idioma está activo, el texto se devuelve en él (los idiomas Beta pueden presentar imprecisiones en términos complejos, con reserva en inglés). Si el idioma está inactivo, `/horoscope/*` y `/reports/*` (enumeración estricta) responden con `400 INVALID_INPUT`, mientras que `/interpret/*` recurre al inglés.
</Aside>

## Estado actual

Cada idioma lleva un **Estado** de traducción más una **Puntuación de demanda** de la hoja de ruta (prioridad, 48–95+).

| # | Código | Idioma | Estado | Demanda | Informes | Sitio |
|---|------|----------|--------|--------|---------|------|
| 1  | `uk` | Ucraniano | ✅ Source | — | ✅ | ✅ |
| 2  | `en` | Inglés | ✅ Reference | **95+** | ✅ | ✅ |
| 3  | `de` | Alemán | 🚧 Auto | 72 | 📋 | ✅ |
| 4  | `pl` | Polaco | 🚧 Auto | 64 | 📋 | ✅ |
| 5  | `es` | Español | 🚧 Auto | **88** | 📋 | ✅ |
| 6  | `pt` | Portugués | 🚧 Auto | **84** | 📋 | ✅ |
| 7  | `hi` | Hindi | 🚧 Auto | **81** | 📋 | ✅ |
| 8  | `fr` | Francés | 🚧 Auto | **78** | 📋 | ✅ |
| 9  | `ko` | Coreano | 🚧 Auto | **77** | 📋 | ✅ |
| 10 | `it` | Italiano | 🚧 Auto | 73 | 📋 | ✅ |
| 11 | `ja` | Japonés | 🚧 Auto | 67 | 📋 | ✅ |
| 12 | `id` | Indonesio | 🚧 Auto | 62 | 📋 | ✅ |
| 13 | `tr` | Turco | 🚧 Auto | 60 | 📋 | ✅ |
| 14 | `nl` | Neerlandés | 🚧 Auto | 58 | 📋 | ✅ |
| 15 | `cs` | Checo | 🚧 Auto | 56 | 📋 | ✅ |
| 16 | `ro` | Rumano | 🚧 Auto | 54 | 📋 | ✅ |
| 17 | `vi` | Vietnamita | 🚧 Auto | 53 | 📋 | ✅ |
| 18 | `ar` | Árabe | 🚧 Auto | 52 | 📋 | ✅ |
| 19 | `el` | Griego | 🚧 Auto | 50 | 📋 | ✅ |
| 20 | `hu` | Húngaro | 🚧 Auto | 48 | 📋 | ✅ |

**Leyenda:**
- **Estado** — ✅ Source / Reference = redactado y mantenido por humanos (uk, en); 🚧 Auto = traducido automáticamente contra un glosario compartido, refinado con el tiempo (todavía sin revisión manual por cadena, por lo que los términos con matices pueden sonar toscos; reserva en inglés en cualquier cadena ausente).
- **Sitio** — ✅ entregado (UI + docs) · 📋 planificado.
- **Informes** — ✅ entregado · 📋 planificado.

## Cómo se producen las traducciones

El ucraniano es el idioma fuente y el inglés la referencia mantenida — ambos redactados por humanos. Cualquier otro idioma se traduce automáticamente contra un glosario astrológico compartido (~800 términos) y se refina con el tiempo; todavía no hay revisión manual por cadena, así que trátalos como Beta en terminología compleja, con reserva en inglés donde falte una cadena. La UI del sitio y la documentación están hoy cubiertas en todos los idiomas listados; los informes PDF localizados se entregan actualmente en ucraniano e inglés y se despliegan al resto según la demanda.

## Puntuación de demanda — cómo se calcula

Un índice compuesto construido a partir de:
- el volumen de Google Trends a 12 meses de las palabras clave de astrología en el país
- la cobertura por parte de los 5 principales competidores (Co–Star, AstroSeek, Astro.com, Prokerala, DivineAPI)
- la población estimada × la penetración estimada de aplicaciones de pago
- el delta de ingresos por usuario (ajustado por PPA)

No es una métrica precisa — una **prioridad clasificada** que ayuda a decidir «qué sigue» de forma objetiva en lugar de por impresión.

## Cómo llamar

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

Respuesta (ejemplo para `language=es`):

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

El campo `language` de la respuesta refleja el idioma aplicado (útil como indicador de UX). El estado de calidad de la traducción está en la tabla anterior; la respuesta de la API **no** lo devuelve.

## Si necesitas un idioma que no está en la lista

Escribe a [hello@astroway.info](mailto:hello@astroway.info) con pruebas de demanda (usuarios de ejemplo, volumen proyectado). Revisamos la lista **trimestralmente** — un idioma con demanda externa real puede añadirse como Tier 4 (opt-in).

Algunos idiomas de la lista corta se **omiten de forma permanente** — `da, fi, no, bg, sk, hr, zh-CN, fa, tl` — debido a un mercado reducido o a la ausencia de tradición astrológica. Están inactivos: `/horoscope/*` y `/reports/*` devuelven `400 INVALID_INPUT`, mientras que `/interpret/*` recurre al inglés.

## Relacionado

- [Precisión de los cálculos](/es/accuracy/) — los cálculos numéricos son **independientes del idioma**, solo se localiza el texto
- [Informes](/es/products/) — informes PDF multilingües
- [Idempotencia](/es/idempotency/) — los descuentos de caché funcionan con independencia de `lang`