# Sprachunterstützung

AstroWay baut eine **mehrsprachige API** — Textdeutungen, Berichte und Tageshoroskope sind in der Sprache des Nutzers verfügbar. Die öffentliche Liste umfasst 20 Sprachen, ausgewählt auf Basis einer Nachfrageanalyse des Astrologie-Markts (Suchvolumen, Wettbewerbsabdeckung, Umsatzpotenzial).

<Aside type="tip">
**So funktioniert es.** Übergeben Sie die Sprache über das Feld `language` im Anfrage-Body — oder `?lang=<code>` in der URL, oder den Header `Accept-Language` — an `/v1/interpret/*`, `/v1/horoscope/*`, `/v1/reports/*`. Ist die Sprache aktiv, kommt der Text in dieser Sprache zurück (Beta-Sprachen können bei komplexen Begriffen Ungenauigkeiten aufweisen, mit englischem Fallback). Ist die Sprache inaktiv, antworten `/horoscope/*` und `/reports/*` (striktes Enum) mit `400 INVALID_INPUT`, während `/interpret/*` auf Englisch zurückfällt.
</Aside>

## Aktueller Status

Jede Sprache trägt einen Übersetzungs-**Status** sowie einen Roadmap-**Nachfragewert** (Priorität, 48–95+).

| # | Code | Sprache | Status | Nachfrage | Berichte | Site |
|---|------|----------|--------|--------|---------|------|
| 1  | `uk` | Ukrainisch | ✅ Source | — | ✅ | ✅ |
| 2  | `en` | Englisch | ✅ Reference | **95+** | ✅ | ✅ |
| 3  | `de` | Deutsch | 🚧 Auto | 72 | 📋 | ✅ |
| 4  | `pl` | Polnisch | 🚧 Auto | 64 | 📋 | ✅ |
| 5  | `es` | Spanisch | 🚧 Auto | **88** | 📋 | ✅ |
| 6  | `pt` | Portugiesisch | 🚧 Auto | **84** | 📋 | ✅ |
| 7  | `hi` | Hindi | 🚧 Auto | **81** | 📋 | ✅ |
| 8  | `fr` | Französisch | 🚧 Auto | **78** | 📋 | ✅ |
| 9  | `ko` | Koreanisch | 🚧 Auto | **77** | 📋 | ✅ |
| 10 | `it` | Italienisch | 🚧 Auto | 73 | 📋 | ✅ |
| 11 | `ja` | Japanisch | 🚧 Auto | 67 | 📋 | ✅ |
| 12 | `id` | Indonesisch | 🚧 Auto | 62 | 📋 | ✅ |
| 13 | `tr` | Türkisch | 🚧 Auto | 60 | 📋 | ✅ |
| 14 | `nl` | Niederländisch | 🚧 Auto | 58 | 📋 | ✅ |
| 15 | `cs` | Tschechisch | 🚧 Auto | 56 | 📋 | ✅ |
| 16 | `ro` | Rumänisch | 🚧 Auto | 54 | 📋 | ✅ |
| 17 | `vi` | Vietnamesisch | 🚧 Auto | 53 | 📋 | ✅ |
| 18 | `ar` | Arabisch | 🚧 Auto | 52 | 📋 | ✅ |
| 19 | `el` | Griechisch | 🚧 Auto | 50 | 📋 | ✅ |
| 20 | `hu` | Ungarisch | 🚧 Auto | 48 | 📋 | ✅ |

**Legende:**
- **Status** — ✅ Source / Reference = von Menschen verfasst und gepflegt (uk, en); 🚧 Auto = automatisch gegen ein gemeinsames Glossar übersetzt, im Laufe der Zeit verfeinert (noch keine manuelle Prüfung pro Zeichenkette, daher können nuancierte Begriffe holprig klingen; englischer Fallback bei jeder fehlenden Zeichenkette).
- **Site** — ✅ ausgeliefert (UI + Docs) · 📋 geplant.
- **Berichte** — ✅ ausgeliefert · 📋 geplant.

## Wie Übersetzungen entstehen

Ukrainisch ist die Ausgangssprache und Englisch die gepflegte Referenz — beide von Menschen verfasst. Jede andere Sprache wird automatisch gegen ein gemeinsames Astrologie-Glossar (~800 Begriffe) übersetzt und im Laufe der Zeit verfeinert; eine manuelle Prüfung pro Zeichenkette gibt es noch nicht, behandeln Sie sie daher bei komplexer Terminologie als Beta, mit englischem Fallback, wo eine Zeichenkette fehlt. Site-UI und Dokumentation sind heute in allen aufgeführten Sprachen abgedeckt; lokalisierte PDF-Berichte erscheinen derzeit auf Ukrainisch und Englisch und werden je nach Nachfrage auf die übrigen ausgerollt.

## Nachfragewert — wie er berechnet wird

Ein zusammengesetzter Index, der sich zusammensetzt aus:
- Google-Trends-Volumen über 12 Monate für Astrologie-Keywords im jeweiligen Land
- Abdeckung durch die Top-5-Wettbewerber (Co–Star, AstroSeek, Astro.com, Prokerala, DivineAPI)
- Geschätzte Bevölkerung × geschätzte Durchdringung kostenpflichtiger Apps
- Umsatz-pro-Nutzer-Delta (kaufkraftbereinigt)

Keine präzise Kennzahl — eine **gereihte Priorität**, die hilft, „was als Nächstes kommt" objektiv zu entscheiden statt nach Bauchgefühl.

## Wie man aufruft

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

Antwort (Beispiel für `language=es`):

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

Das Feld `language` in der Antwort spiegelt die angewendete Sprache wider (praktisch als UX-Indikator). Der Status der Übersetzungsqualität steht in der Tabelle oben; die API-Antwort gibt ihn **nicht** zurück.

## Wenn Sie eine Sprache benötigen, die nicht auf der Liste steht

Schreiben Sie an [hello@astroway.info](mailto:hello@astroway.info) mit Nachfragenachweisen (Beispielnutzer, prognostiziertes Volumen). Wir prüfen die Liste **vierteljährlich** — eine Sprache mit echter externer Nachfrage kann als Tier 4 (opt-in) hinzugefügt werden.

Einige Sprachen der engeren Auswahl werden **dauerhaft übersprungen** — `da, fi, no, bg, sk, hr, zh-CN, fa, tl` — wegen kleinen Marktes oder fehlender Astrologie-Tradition. Sie sind inaktiv: `/horoscope/*` und `/reports/*` geben `400 INVALID_INPUT` zurück, während `/interpret/*` auf Englisch zurückfällt.

## Verwandt

- [Berechnungsgenauigkeit](/de/accuracy/) — numerische Berechnungen sind **sprachneutral**, nur der Text wird lokalisiert
- [Berichte](/de/products/) — mehrsprachige PDF-Berichte
- [Idempotenz](/de/idempotency/) — Cache-Rabatte funktionieren unabhängig von `lang`