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

Consejo

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.

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

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):

{
  "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 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 — los cálculos numéricos son independientes del idioma, solo se localiza el texto
• Informes — informes PDF multilingües
• Idempotencia — los descuentos de caché funcionan con independencia de lang