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

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

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

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

REST API Swiss Ephemeris पर आधारित है - अब वास्तविक गणनाओं के ऊपर AI‑व्याख्याएँ भी हैं। वही इंजन जिसका उपयोग पेशेवर ज्योतिषी 30+ सालों से Solar Fire, Kepler, Astro Gold और Janus में करते हैं - कोणीय सेकंड के अंश तक की सटीकता, NASA JPL की एफ़ेमेरिड और Astrodienst (Astro.com) के आधिकारिक swetest रेफ़रेंस से मिलान किया गया।

संख्याएँ:

• 865 एंडपॉइंट: पश्चिमी नैटल ज्योतिष, सिनास्ट्रि, ट्रांज़िट, प्रोग्रेशन, डायरेक्शन, रिटर्न, हार्मोनिक्स, फिक्स्ड स्टार्स, अरबिक पॉइंट्स, एस्ट्रोकार्टोग्राफी प्लस Human Design का पूरा सेट
• 183 स्नैपशॉट‑टेस्ट CI में वास्तविक swetest CGI आउटपुट और NASA इवैजन कैटलॉग के खिलाफ - हर PR पर चलते हैं
• p50 < 100 ms, p95 < 500 ms सामान्य गणनात्मक एंडपॉइंट्स के लिए
• MCP‑सर्वर @astroway/mcp + तीन SDK public registries पर: @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 के लिए, फिर Marketing साइट astroway.info के लिए, जो महीने में सैकड़ों हज़ार विज़िटर्स को दैनिक राशिफल देता है।

प्रोडक्शन में इस कोड के तीन साल के काम के बाद हमने दो निष्कर्ष निकाले:

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

यही है लॉन्च।

हमारे पास /nakshatras, /ashtakavarga और divisional‑चार्ट के एंडपॉइंट हैं, लेकिन Dasha, Panchang, Ashtakoota, KP नहीं हैं। कारण: वेदिक ज्योतिष में स्कूलों के बीच अनसुलझे मतभेद हैं (आयनामश युद्ध, KP के कुश्पिड पर बहस, दाशा स्कूल का चयन)। वेदिक भाग को 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+ प्लान में यह की सेटिंग्स में हटाया जाता है। पैटर्न Zapier और RevenueCat से उधार लिया गया है।

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

/interpret/* एंडपॉइंट हमारे निजी AI‑gateway के माध्यम से कई मॉडलों के बीच ऑटोमैटिक फेलओवर के साथ काम करते हैं। हम तुम्हें अपने प्रॉम्प्ट्स में बंद नहीं करते - प्रत्येक व्याख्या उत्तर में मूल गणना शामिल होती है, इसलिए अगर हमारी आवाज़ तुम्हें पसंद नहीं तो तुम अपनी LLM से री‑प्रोग्राम कर सकते हो। पूर्ण प्रॉम्प्ट और आउटपुट हम audit‑टेबल में B2B‑कम्प्लायंस के लिए लॉग करते हैं (90 दिन तक रखे जाते हैं)।

• वेदिक पैकेज: फेज 3, शुरुआती मांग की पुष्टि के बाद (ऊपर देखें)
• थ्रेशहोल्ड पर Webhook: लागू किए गए हैं, लेकिन UI कच्चा है; हम सुधार रहे हैं
• पब्लिक विजेट (<script src="api.astroway.info/widget/natal.js">) - फेज 7
• मुख्य Marketing साइट के लिए प्लगइन: अलग प्रोजेक्ट, इकोसिस्टम 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 पर कुछ बनाता है - या बग पकड़ता है, या ऐसा एंडपॉइंट चाहता है जो अभी नहीं है - हमें लिख। हमें सौ डेवलपर्स की मांग सुनना बेहतर लगता है, बजाय उन फीचर्स को लॉन्च करने के जो कोई इस्तेमाल नहीं करता।

सवाल, अनुरोध, अजीब edge‑केस: hello@astroway.info.

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

स्वागत है।