# Suporte de idiomas

A AstroWay está a construir uma **API multilingue** — interpretações de texto, relatórios e horóscopos diários estão disponíveis no idioma do utilizador. A lista pública é de 20 idiomas, selecionados a partir de uma pesquisa de procura do mercado de astrologia (volume de pesquisa, cobertura dos concorrentes, potencial de receita).

<Aside type="tip">
**Como funciona.** Indique o idioma através do campo `language` no corpo do pedido — ou `?lang=<code>` no URL, ou o cabeçalho `Accept-Language` — para `/v1/interpret/*`, `/v1/horoscope/*`, `/v1/reports/*`. Se o idioma estiver ativo, o texto é devolvido nele (os idiomas em Beta podem ter imprecisões em termos complexos, com recurso ao inglês). Se o idioma estiver inativo, `/horoscope/*` e `/reports/*` (enum estrito) respondem com `400 INVALID_INPUT`, enquanto `/interpret/*` recorre ao inglês.
</Aside>

## Estado atual

Cada idioma tem um **Status** de tradução mais uma **Demand score** de roteiro (prioridade, 48–95+).

| # | Code | Idioma | Status | Demand | Reports | Site |
|---|------|----------|--------|--------|---------|------|
| 1  | `uk` | Ucraniano | ✅ Source | — | ✅ | ✅ |
| 2  | `en` | Inglês | ✅ Reference | **95+** | ✅ | ✅ |
| 3  | `de` | Alemão | 🚧 Auto | 72 | 📋 | ✅ |
| 4  | `pl` | Polaco | 🚧 Auto | 64 | 📋 | ✅ |
| 5  | `es` | Espanhol | 🚧 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` | Indonésio | 🚧 Auto | 62 | 📋 | ✅ |
| 13 | `tr` | Turco | 🚧 Auto | 60 | 📋 | ✅ |
| 14 | `nl` | Neerlandês | 🚧 Auto | 58 | 📋 | ✅ |
| 15 | `cs` | Checo | 🚧 Auto | 56 | 📋 | ✅ |
| 16 | `ro` | Romeno | 🚧 Auto | 54 | 📋 | ✅ |
| 17 | `vi` | Vietnamita | 🚧 Auto | 53 | 📋 | ✅ |
| 18 | `ar` | Árabe | 🚧 Auto | 52 | 📋 | ✅ |
| 19 | `el` | Grego | 🚧 Auto | 50 | 📋 | ✅ |
| 20 | `hu` | Húngaro | 🚧 Auto | 48 | 📋 | ✅ |

**Legenda:**
- **Status** — ✅ Source / Reference = redigido e mantido por humanos (uk, en); 🚧 Auto = traduzido automaticamente com base num glossário partilhado, aperfeiçoado ao longo do tempo (ainda sem revisão manual por cadeia, pelo que termos com nuances podem soar imperfeitos; recurso ao inglês em qualquer cadeia em falta).
- **Site** — ✅ disponível (UI + documentação) · 📋 planeado.
- **Reports** — ✅ disponível · 📋 planeado.

## Como são produzidas as traduções

O ucraniano é o idioma de origem e o inglês é a referência mantida — ambos redigidos por humanos. Todos os outros idiomas são traduzidos automaticamente com base num glossário de astrologia partilhado (~800 termos) e aperfeiçoados ao longo do tempo; ainda não há revisão manual por cadeia, pelo que devem ser tratados como Beta em terminologia complexa, com recurso ao inglês onde uma cadeia esteja em falta. A UI do site e a documentação estão hoje cobertas em todos os idiomas listados; os relatórios PDF localizados são atualmente disponibilizados em ucraniano e inglês e serão lançados para os restantes conforme a procura.

## Demand Score — como é calculado

Um índice composto construído a partir de:
- Volume de 12 meses do Google Trends em palavras-chave de astrologia no país
- Cobertura pelos 5 principais concorrentes (Co–Star, AstroSeek, Astro.com, Prokerala, DivineAPI)
- População estimada × penetração estimada de aplicações pagas
- Diferencial de receita por utilizador (ajustado por PPC)

Não é uma métrica exata — é uma **prioridade ordenada** que ajuda a decidir "o que vem a seguir" de forma objetiva, em vez de por impressão.

## Como chamar

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

Resposta (exemplo para `language=es`):

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

O campo `language` na resposta repete o idioma aplicado (útil como indicador de UX). O estado da qualidade da tradução está na tabela acima; a resposta da API **não** o devolve.

## Se precisar de um idioma que não está na lista

Envie um e-mail para [hello@astroway.info](mailto:hello@astroway.info) com evidências de procura (amostra de utilizadores, volume projetado). Revemos a lista **trimestralmente** — um idioma com procura externa real pode ser adicionado como Tier 4 (opt-in).

Alguns idiomas da lista restrita são **permanentemente excluídos** — `da, fi, no, bg, sk, hr, zh-CN, fa, tl` — devido a um mercado reduzido ou à ausência de tradição astrológica. Estão inativos: `/horoscope/*` e `/reports/*` devolvem `400 INVALID_INPUT`, enquanto `/interpret/*` recorre ao inglês.

## Relacionado

- [Precisão dos cálculos](/pt/accuracy/) — os cálculos numéricos são **neutros em relação ao idioma**, apenas o texto é localizado
- [Relatórios](/pt/products/) — relatórios PDF multilingues
- [Idempotência](/pt/idempotency/) — os descontos de cache funcionam de forma independente do `lang`