भाषा समर्थन

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

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

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

प्रत्येक भाषा एक अनुवाद 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-समायोजित)

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

कैसे कॉल करें

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 के लिए नमूना):

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

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

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

माँग के प्रमाण (नमूना उपयोगकर्ता, अनुमानित मात्रा) के साथ 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 करता है।