कैटलॉग मानचित्र: कैसे व्यवस्थित हैं 700+ एन्डपॉइंट्स AstroWay

AstroWay कैटलॉग में पहले से ही 57 समूहों में 865 endpoints हैं। इस पैमाने पर, इंटीग्रेटर का मुख्य प्रश्न यह नहीं है कि “क्या कवरेज पर्याप्त होगा”, बल्कि यह है कि “कैसे खो न जाएं”। यह लेख एक मानचित्र है: कैटलॉग को डोमेन में कैसे बांटा गया है और एक मिनट में अपनी ज़रूरत का कैसे पता लगाएं।

डोमेन की परवाह किए बिना, प्रत्येक गणना endpoint का एक ही रूप है:

POST /v1/{domain}/{calc}
X-Api-Key: aw_live_...
Content-Type: application/json

बॉडी - JSON जिसमें जन्म डेटा (दिनांक, समय, निर्देशांक) या तकनीक-विशिष्ट पैरामीटर होते हैं। प्रतिक्रिया - हमेशा { "ok": true, "data": {...} } या { "ok": false, "error": {...} }। कोई GraphQL नहीं, डोमेन के लिए कोई अलग auth-flow नहीं: X-Api-Key हेडर में एक कुंजी, प्रतिक्रिया का एक ही प्रारूप।

इसका मतलब है कि जो रैपर तुम नेटल चार्ट के लिए लिखते हो, वह BaZi और runes दोनों के लिए उपयुक्त है - केवल पथ और बॉडी स्कीमा बदलता है।

कैटलॉग को बड़े डोमेन में समूहित किया गया है। यहाँ वास्तविक काउंटरों के साथ एक मानचित्र है (संख्याएँ प्रत्येक बिल्ड पर मैनिफेस्ट से ली जाती हैं, इसलिए वे यहाँ हमेशा अद्यतित रहती हैं):

बाकी - AI-व्याख्याएँ, राशिफल, संदर्भ endpoints (राशियाँ, ग्रह, पहलू) और सिस्टम संबंधी (स्वास्थ्य, उपयोग, ओपनएपीआई)।

230 वैदिक endpoints पूरे पश्चिमी भाग से अधिक हैं। कारण सरल है: वैदिक परंपरा अधिक औपचारिक है। जहाँ पश्चिमी ज्योतिष में घरों का एक सेट होता है, वहीं वैदिक में 16 डिवीजनल-चार्ट (वर्ग), कई दशा प्रणालियाँ, स्पष्ट नियमों के साथ दर्जनों योग होते हैं। इनमें से प्रत्येक एक निश्चित परिणाम के साथ एक अलग endpoint है।

यदि तुम भारतीय बाजार के लिए निर्माण कर रहे हो, तो यह उत्पाद का मूल है, न कि एक अतिरिक्त सुविधा।

तकनीक की विशिष्टता की परवाह किए बिना, ग्रहों की स्थिति की गणना स्विस एफेमेरिस पर एक ही कोर द्वारा की जाती है। वही कोर हमारे एप्लिकेशन में भी और API में भी काम करता है - एक ही कोडबेस, कोई विसंगति नहीं। गणना endpoints 888 स्नैपशॉट-टेस्ट द्वारा कवर किए गए हैं, जो प्रत्येक PR पर संदर्भ स्रोतों के साथ सत्यापित होते हैं। इसके बारे में अधिक जानकारी CI-सटीकता पर एक अलग लेख में है।

तीन तरीके, सबसे तेज़ से शुरू करते हुए:

1. OpenAPI-संदर्भ - /docs/api/ सीधे openapi.json की उत्पादन-विशिष्टता से उत्पन्न होता है। साइडबार में समूह = ऊपर दिए गए डोमेन। प्रत्येक endpoint में बॉडी स्कीमा, एक उदाहरण और “प्रयास करें” बटन होता है।
2. MCP-कैटलॉग - यदि तुम Claude या Cursor में हो, तो पूरा कैटलॉग mcp.astroway.info के माध्यम से उपकरणों के एक सेट के रूप में उपलब्ध है। एजेंट स्वयं विवरण के आधार पर आवश्यक endpoint ढूंढता है।
3. विशिष्टता द्वारा खोज - curl https://api.astroway.info/v1/openapi.json एक पूर्ण मशीन-पठनीय अनुबंध देता है। अपने स्वयं के क्लाइंट के कोड-जनरेशन के लिए सुविधाजनक।

dashboard/sign-up पर कुंजी प्रति माह 10,000 क्रेडिट देती है - दर्जनों डोमेन से गुजरने और यह समझने के लिए पर्याप्त है कि इसमें से तुम्हारा क्या है। कैटलॉग को पूरी तरह से अध्ययन करने की आवश्यकता नहीं है: अपना डोमेन लो, और बाकी तब तक इंतजार करेगा जब तक इसकी आवश्यकता न हो।