# भाषा समर्थन

AstroWay एक **बहुभाषी API** बना रहा है — टेक्स्ट व्याख्याएँ, रिपोर्ट्स और दैनिक राशिफल उपयोगकर्ता की भाषा में उपलब्ध हैं। सार्वजनिक सूची 20 भाषाओं की है, जिन्हें ज्योतिष-बाज़ार माँग अनुसंधान (खोज मात्रा, प्रतिस्पर्धी कवरेज, राजस्व संभावना) के आधार पर चुना गया है।

<Aside type="tip">
**यह कैसे काम करता है।** भाषा को अनुरोध के मुख्य भाग में `language` फ़ील्ड के माध्यम से पास करें — या URL में `?lang=<code>`, या `Accept-Language` हेडर — `/v1/interpret/*`, `/v1/horoscope/*`, `/v1/reports/*` को। यदि भाषा सक्रिय है, तो टेक्स्ट उसी में लौटता है (Beta भाषाओं में जटिल शब्दों पर अशुद्धियाँ हो सकती हैं, अंग्रेज़ी fallback के साथ)। यदि भाषा निष्क्रिय है, तो `/horoscope/*` और `/reports/*` (strict enum) `400 INVALID_INPUT` के साथ उत्तर देते हैं, जबकि `/interpret/*` अंग्रेज़ी पर fallback करता है।
</Aside>

## वर्तमान स्थिति

प्रत्येक भाषा एक अनुवाद **Status** के साथ-साथ एक रोडमैप **Demand score** (प्राथमिकता, 48–95+) वहन करती है।

| # | Code | Language | Status | Demand | Reports | Site |
|---|------|----------|--------|--------|---------|------|
| 1  | `uk` | यूक्रेनी | ✅ Source | — | ✅ | ✅ |
| 2  | `en` | अंग्रेज़ी | ✅ Reference | **95+** | ✅ | ✅ |
| 3  | `de` | जर्मन | 🚧 Auto | 72 | 📋 | ✅ |
| 4  | `pl` | पोलिश | 🚧 Auto | 64 | 📋 | ✅ |
| 5  | `es` | स्पेनिश | 🚧 Auto | **88** | 📋 | ✅ |
| 6  | `pt` | पुर्तगाली | 🚧 Auto | **84** | 📋 | ✅ |
| 7  | `hi` | हिन्दी | 🚧 Auto | **81** | 📋 | ✅ |
| 8  | `fr` | फ़्रेंच | 🚧 Auto | **78** | 📋 | ✅ |
| 9  | `ko` | कोरियाई | 🚧 Auto | **77** | 📋 | ✅ |
| 10 | `it` | इतालवी | 🚧 Auto | 73 | 📋 | ✅ |
| 11 | `ja` | जापानी | 🚧 Auto | 67 | 📋 | ✅ |
| 12 | `id` | इंडोनेशियाई | 🚧 Auto | 62 | 📋 | ✅ |
| 13 | `tr` | तुर्की | 🚧 Auto | 60 | 📋 | ✅ |
| 14 | `nl` | डच | 🚧 Auto | 58 | 📋 | ✅ |
| 15 | `cs` | चेक | 🚧 Auto | 56 | 📋 | ✅ |
| 16 | `ro` | रोमानियाई | 🚧 Auto | 54 | 📋 | ✅ |
| 17 | `vi` | वियतनामी | 🚧 Auto | 53 | 📋 | ✅ |
| 18 | `ar` | अरबी | 🚧 Auto | 52 | 📋 | ✅ |
| 19 | `el` | यूनानी | 🚧 Auto | 50 | 📋 | ✅ |
| 20 | `hu` | हंगेरियन | 🚧 Auto | 48 | 📋 | ✅ |

**Legend:**
- **Status** — ✅ Source / Reference = मानव-रचित और अनुरक्षित (uk, en); 🚧 Auto = एक साझा शब्दावली के विरुद्ध स्वचालित रूप से अनूदित, समय के साथ परिष्कृत (अभी तक कोई प्रति-स्ट्रिंग मैनुअल समीक्षा नहीं, इसलिए सूक्ष्म शब्द कठोर पढ़े जा सकते हैं; किसी भी अनुपस्थित स्ट्रिंग पर अंग्रेज़ी fallback)।
- **Site** — ✅ शिप किया गया (UI + docs) · 📋 नियोजित।
- **Reports** — ✅ शिप किया गया · 📋 नियोजित।

## अनुवाद कैसे तैयार किए जाते हैं

यूक्रेनी स्रोत भाषा है और अंग्रेज़ी अनुरक्षित संदर्भ है — दोनों मानव-रचित हैं। हर दूसरी भाषा एक साझा ज्योतिष शब्दावली (~800 शब्द) के विरुद्ध स्वचालित रूप से अनूदित होती है और समय के साथ परिष्कृत होती है; अभी तक कोई प्रति-स्ट्रिंग मैनुअल समीक्षा नहीं है, इसलिए जटिल शब्दावली पर उन्हें Beta मानें, जहाँ कोई स्ट्रिंग अनुपस्थित हो वहाँ अंग्रेज़ी fallback के साथ। साइट UI और दस्तावेज़ीकरण आज सभी सूचीबद्ध भाषाओं में कवर हैं; स्थानीयकृत PDF रिपोर्ट्स वर्तमान में यूक्रेनी और अंग्रेज़ी में शिप होती हैं और माँग के अनुसार बाकियों तक पहुँचती हैं।

## Demand Score — इसकी गणना कैसे होती है

एक मिश्रित सूचकांक, जो इनसे निर्मित होता है:
- देश में ज्योतिष कीवर्ड पर Google Trends की 12-महीने की मात्रा
- top-5 प्रतिस्पर्धियों (Co–Star, AstroSeek, Astro.com, Prokerala, DivineAPI) द्वारा कवरेज
- अनुमानित जनसंख्या × अनुमानित paid-app प्रवेश
- राजस्व-प्रति-उपयोगकर्ता अंतर (PPP-समायोजित)

यह कोई सटीक मीट्रिक नहीं — एक **क्रमबद्ध प्राथमिकता** है, जो "आगे क्या" का निर्णय धारणा के बजाय वस्तुनिष्ठ रूप से लेने में मदद करती है।

## कैसे कॉल करें

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

उत्तर (`language=es` के लिए नमूना):

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

response में `language` फ़ील्ड लागू की गई भाषा को प्रतिध्वनित करता है (UX संकेतक के रूप में सुविधाजनक)। अनुवाद-गुणवत्ता स्थिति ऊपर की तालिका में है; API response इसे **नहीं** लौटाता।

## यदि आपको सूची में न होने वाली भाषा चाहिए

माँग के प्रमाण (नमूना उपयोगकर्ता, अनुमानित मात्रा) के साथ [hello@astroway.info](mailto:hello@astroway.info) पर ईमेल करें। हम सूची की समीक्षा **तिमाही** करते हैं — वास्तविक बाहरी माँग वाली भाषा को Tier 4 (opt-in) के रूप में जोड़ा जा सकता है।

short-list की कुछ भाषाएँ **स्थायी रूप से छोड़ दी गई** हैं — `da, fi, no, bg, sk, hr, zh-CN, fa, tl` — छोटे बाज़ार या अनुपस्थित ज्योतिष परंपरा के कारण। वे निष्क्रिय हैं: `/horoscope/*` और `/reports/*` `400 INVALID_INPUT` लौटाते हैं, जबकि `/interpret/*` अंग्रेज़ी पर fallback करता है।

## संबंधित

- [गणना की सटीकता](/hi/accuracy/) — संख्यात्मक गणनाएँ **भाषा-निरपेक्ष** हैं, केवल टेक्स्ट स्थानीयकृत होता है
- [रिपोर्ट्स](/hi/products/) — बहुभाषी PDF रिपोर्ट्स
- [Idempotency](/hi/idempotency/) — cache छूट `lang` से स्वतंत्र रूप से काम करती हैं