एस्ट्रोवे एपीआई लॉन्च: स्विस एफिमेरिस की सटीकता के साथ ज्योतिष गणना का पूरा स्टैक

आज हम AstroWay API - एक कम्प्यूटेशनल बैकएंड लॉन्च कर रहे हैं, जो उन डेवलपर्स के लिए है जो एस्ट्रोलॉजी ऐप्स, होरोस्कोप उत्पाद, डेटिंग ऐप्स के लिए संगतता सुविधाएँ, और जन्म कुंडली के बारे में तर्क करने वाले AI एजेंट्स बना रहे हैं।

इस लेख में - API के अंदर वास्तव में क्या है, हमने कौन से असामान्य निर्णय लिए, हमने क्या जानबूझकर छोड़ा, और हम यहां कैसे पहुंचे। बिना किसी बेकार की बातों के।

🕓 पोस्ट किया गया 2026-04-22, अपडेट किया गया 2026-05-09। कुछ आंकड़े पुराने हो चुके हैं। वर्तमान स्थिति: 758 एंडपॉइंट (लॉन्च के समय के 87 नहीं), 873 CI स्नैपशॉट टेस्ट (183 नहीं), MCP-सर्वर @astroway/mcp + TypeScript SDK @astroway/sdk + Python SDK astroway + PHP SDK astroway/sdk अब सभी सार्वजनिक रजिस्ट्रीज़ पर उपलब्ध हैं। नवीनतम स्थिति - /faq और changelog पर देखें।

Swiss Ephemeris (LGPL) पर आधारित REST API, जिसे WASM में कंपाइल किया गया है और Node.js सेवा के रूप में डिप्लॉय किया गया है - अब AI-व्याख्याओं (GPT-4 / Claude / Llama 3.3 / Gemini / DeepSeek / Mistral का फेलओवर चेन) के साथ वास्तविक गणनाओं के ऊपर। वही इंजन है जिसका उपयोग पेशेवर एस्ट्रोलॉजिस्ट 30+ वर्षों से Solar Fire, Kepler, Astro Gold और Janus में करते आ रहे हैं - NASA JPL एफेमेराइड और Astrodienst (Astro.com) के आधिकारिक swetest रेफरेंस के साथ मिलान की गई सटीकता, कोणीय सेकंड के अंश तक।

आंकड़े:

• 758 एंडपॉइंट - पश्चिमी जन्म कुंडली ज्योतिष, सिनास्ट्री, ट्रांज़िट, प्रोग्रेशन, डायरेक्शंस, रिटर्न, हार्मोनिक्स, फिक्स्ड स्टार्स, अरबी पॉइंट्स, एस्ट्रोकार्टोग्राफी, और Human Design का पूरा सेट
• 183 स्नैपशॉट टेस्ट CI में वास्तविक swetest CGI आउटपुट और NASA ग्रहण कैटलॉग के खिलाफ - हर PR पर चलाए जाते हैं
• p50 < 100ms, p95 < 500ms सामान्य कम्प्यूटेशनल एंडपॉइंट्स के लिए
• MCP-सर्वर @astroway/mcp + तीन SDK सार्वजनिक रजिस्ट्रीज़ पर: @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - वही API तीन भाषाओं में
• MCP-सर्वर: @astroway/mcp - API को Claude, GPT, Cursor और अन्य LLM एजेंट्स के लिए टूल के रूप में प्रदान करता है
• क्रेडिट-आधारित मूल्य निर्धारण: मुफ्त योजना (10,000 क्रेडिट/माह, कार्ड की आवश्यकता नहीं), सशुल्क - $5/माह से शुरू

पूर्ण संदर्भ: api.astroway.info/docs/api/। लाइव स्थिति: api.astroway.info/status।

तीन साल पहले हमने उपभोक्ता एस्ट्रोलॉजी ऐप्स बनाना शुरू किया था। कम्प्यूटेशनल लेयर सबसे कठिन हिस्सा निकला - UI या कंटेंट की तुलना में कहीं अधिक जटिल। मौजूदा सेवाओं में या तो:

1. अपर्याप्त कवरेज था (केवल 10–30 एंडपॉइंट, मुख्यतः केवल जन्म कुंडली तक सीमित)
2. बड़े पैमाने पर महंगे थे ($0.02–$0.10 प्रति अनुरोध, थोक छूट के बिना)
3. बंद इंजन का उपयोग करते थे जिनकी सटीकता सत्यापित नहीं की जा सकती
4. वेदिक ज्योतिष पर केंद्रित थे, जबकि पश्चिमी ज्योतिष को गौण माना जाता था

इसलिए हमने Swiss Ephemeris को स्वयं वेंडर किया और अपना खुद का कम्प्यूटेशनल लेयर लिखा - पहले उपभोक्ता उत्पाद app.astroway.info के लिए, फिर मार्केटिंग साइट astroway.info के लिए, जो हर महीने लाखों विज़िटर्स को दैनिक होरोस्कोप प्रदान करता है।

तीन साल के उत्पादन उपयोग के बाद, हमें दो निष्कर्ष मिले:

1. वही कम्प्यूटेशनल इंजन अन्य डेवलपर्स के लिए उपलब्ध होना चाहिए - न कि इसलिए कि वे इसे स्वयं नहीं बना सकते, बल्कि इसलिए कि लाइब्रेरी + WASM + कैशिंग + सटीकता के लिए CI स्टैक को बनाने में छह महीने लग जाते हैं, जिसे दोहराना किसी के लिए भी उचित नहीं।
2. हमारा Human Design कवरेज (12 एंडपॉइंट - चार्ट, टाइप, अथॉरिटी, प्रोफाइल, गेट्स, चैनल्स, सर्किट्स, प्लैनेटरी एक्टिवेशन, इन्कार्नेशन क्रॉस, डेफिनेशन) वास्तव में अद्वितीय है। कोई प्रतियोगी पूर्ण HD स्टैक API के माध्यम से प्रदान नहीं करता।

यही है लॉन्च।

हमारे पास /nakshatras, /ashtakavarga और विभाजन चार्ट के लिए एंडपॉइंट हैं, लेकिन Dasha, Panchang, Ashtakoota, KP नहीं हैं। कारण: वेदिक ज्योतिष में स्कूलों के बीच असहमतियों का अभाव है (आयनामश युद्ध, KP कस्पिड विवाद, दasha स्कूल का चुनाव)। जल्दबाजी में बनाया गया वेदिक हिस्सा Prokerala या VedicAstroAPI की तरह आलोचना का पात्र बन जाता।

निर्णय तय है: वेदिक पैकेज चरण 3 है, जब पश्चिमी ज्योतिष पर स्थिर मांग स्थापित हो जाएगी और इसे Jagannatha Hora और Parashara’s Light के विरुद्ध मान्य किया जा सकेगा। खराब लॉन्च करने से बेहतर है बिल्कुल लॉन्च न किया जाए।

एक /chart कॉल में लगभग 50 गुना कम कम्प्यूटेशन लगता है जितना कि 365-दिवसीय /forecast-calendar में। फ्लैट प्रति-अनुरोध मूल्य हल्के उपयोगकर्ताओं को काट देगा या भारी उपयोगकर्ताओं को सब्सिडी देगा। क्रेडिट वास्तविक कार्य लागत के अनुरूप हैं - मूल्य निर्धारण पृष्ठ पर एंडपॉइंट द्वारा टेबल देखें।

मुफ्त योजना के उत्तर _footer फ़ील्ड शामिल करते हैं:

{
  "data": { ... },
  "_footer": "Powered by astroway.api - get your own key at https://api.astroway.info"
}

हमें यह कुछ भी नहीं खर्च करता, और मुफ्त उपयोगकर्ताओं को अपग्रेड करने के लिए थोड़ा प्रोत्साहन देता है। Hobby+ योजना पर इसे API कुंजी सेटिंग में हटाया जा सकता है। पैटर्न Zapier और RevenueCat से लिया गया है।

/rectification (जीवन की घटनाओं के माध्यम से जन्म समय निर्धारण, likelihood-grid खोज) कम्प्यूटेशनल रूप से महंगा है: एक कॉल में 10–60 सेकंड लगते हैं और इसमें Swiss Ephemeris के दसियों हज़ार मध्यवर्ती गणनाएँ शामिल होती हैं। हमने इसे Pro योजना ($59/माह) तक सीमित कर दिया है और उच्च क्रेडिट मूल्य निर्धारित किया है, क्योंकि इसका दुरुपयोग सभी के लिए साझा इन्फ्रास्ट्रक्चर को प्रभावित कर सकता है।

/interpret/* एंडपॉइंट हमारे निजी AI-gateway के माध्यम से रूट होते हैं, जो बाज़ार की सर्वश्रेष्ठ मॉडल्स (Google Gemini → Groq → OpenRouter → Cerebras → SambaNova → Mistral) के माध्यम से failover के साथ काम करता है। हम तुम्हें अपने प्रॉम्प्ट में बंद नहीं करते - हर व्याख्या उत्तर में मूल गणनाएँ शामिल होती हैं, इसलिए यदि हमारी आवाज़ तुम्हें पसंद नहीं आती तो तुम अपने LLM को स्वैप कर सकते हो। पूर्ण प्रॉम्प्ट और आउटपुट B2B अनुपालन के लिए ऑडिट टेबल में 90 दिनों तक लॉग किए जाते हैं।

• वेदिक पैकेज - चरण 3, पश्चिमी ज्योतिष पर शुरुआती मांग के बाद (ऊपर देखें)
• थ्रेशोल्ड ट्रिगर्स के लिए वेबहुक - लागू किए गए हैं, लेकिन UI कच्चा है; हम इसे पूरा कर रहे हैं
• सार्वजनिक विजेट (<script src="api.astroway.info/widget/natal.js">) - चरण 7
• मार्केटिंग साइट के लिए प्लगइन - अलग परियोजना, astroway.info पारिस्थितिकी तंत्र के हिस्से के रूप में नियोजित

1. दस्तावेज़ पढ़ो अगर तुम “क्यों” समझना चाहते हो: api.astroway.info/overview
2. 5 मिनट में कोड के साथ क्विक स्टार्ट: Astrology API Quick Start
3. मूल्य निर्धारण, जिसमें एंडपॉइंट द्वारा क्रेडिट टेबल शामिल है: api.astroway.info/pricing
4. रजिस्टर करो - मुफ्त, कार्ड की आवश्यकता नहीं: api.astroway.info/dashboard/sign-up

अगर तुम API पर कुछ बना रहे हो - या तुम्हें कोई बग मिला है, या तुम्हारे पास ऐसा एंडपॉइंट है जो हमारे पास नहीं है - हमें बताओ। हमें 100 डेवलपर्स से सुनना बेहतर है जो कुछ मांग रहे हैं, बजाय ऐसे फीचर्स लॉन्च करने के जिनका कोई इस्तेमाल नहीं करता।

प्रश्न, अनुरोध, अजीब edge-cases: hello@astroway.info।

रोडमैप सार्वजनिक है - PRODUCT-PLAN.md - क्या किया गया, क्या अगला है, क्या स्थगित है और क्यों।

स्वागत है।