इंजीनियरिंग नोट्स।
एफेमेरिस की सटीकता, गणना वास्तुकला, MCP प्रोटोकॉल और उन छोटी-छोटी बातों के बारे में जो docs में नहीं आतीं।
डॉक्यूमेंटेशन, AI-एजेंट्स के लिए बनाया गया, न कि केवल लोगों के लिए
क्लासिक डॉक्यूमेंटेशन मानव पढ़ने के लिए बनाया गया: सुंदर HTML, कोड हाइलाइटिंग, नेविगेशन। लेकिन अब डॉक्यूमेंटेशन पर ट्रैफ़िक का आधा हिस्सा एजेंट और असिस्टेंट हैं, जिन्हें plain-text चाहिए, render नहीं। हम क्या जोड़े हैं: प्रत्येक पेज का .md-डुप्लिकेट, llms.txt, मशीन-पढ़ने योग्य विशिष्टताएँ, ड्रॉपडाउन "ChatGPT / Claude में खोलें" और inline try-it।
पढ़ें →API में न्यूमेरोलॉजी: एक ही मार्ग पर 5 प्रणालियाँ
अधिकांश API या तो बिल्कुल न्यूमेरोलॉजी नहीं रखते, या केवल एक पायथागोरियन प्रणाली प्रदान करते हैं। हमारे पास 5 पूर्ण प्रणालियाँ (पायथागोरियन, हैल्डियन, दो काबालिस्टिक, वैदिक) प्रत्येक में 10 गणनाएँ, एक ही parameterized मार्ग पर। साथ ही 22 आर्कानों के लिए भाग्य मैट्रिक्स।
पढ़ें →टाइप्ड आउटपुट MCP: क्यों 600+ टूल्स के पास outputSchema है
अधिकांश MCP-सर्वर एजेंट को अनटाइप्ड JSON देते हैं - मॉडल को उत्तर के फ़ॉर्म को अनुमानित करना पड़ता है। हम 600+ टूल्स के लिए सख्त outputSchema प्रकाशित करते हैं। हम देखते हैं कि यह कैसे काम करता है, किस बग ने strict-mode क्लाइंट्स में समस्या पैदा की और हमने इसे खुले स्कीमा के माध्यम से कैसे ठीक किया।
पढ़ें →कैटलॉग मानचित्र: कैसे व्यवस्थित हैं 700+ एन्डपॉइंट्स AstroWay
API बढ़ गया है 700 से अधिक एन्डपॉइंट्स में 57 समूहों में - जन्म कुंडली से BaZi, जियोमांट्री और SVG-मानचित्रों के रेंडर तक। हम देखते हैं कि कैसे कैटलॉग डोमेनों में विभाजित है, जहाँ सभी कॉल्स एक ही पैटर्न का पालन करते हैं और आवश्यक एन्डपॉइंट को जल्दी कैसे खोजें।
पढ़ें →हम सटीकता को नियंत्रण में कैसे रखते हैं: swetest और NASA के विरुद्ध CI
किसी एस्ट्रो API की सटीकता एफ़ेमेरिस कोड के एक ही रिफ़ैक्टरिंग से आसानी से बिगड़ सकती है। हम सुरक्षा के तरीके को समझाते हैं: ऐप और API के लिए एक ही Swiss Ephemeris कोर, संदर्भ कुंडलियों पर सैकड़ों फ़्रीज़ किए गए स्नैपशॉट, और हर PR का swetest CGI, Kerykeion, Prokerala तथा NASA ग्रहण कैटलॉग के विरुद्ध ट्रायंगुलेशन।
पढ़ें →तीन आधिकारिक SDK: TypeScript, Python, PHP कच्चे curl के बजाय
कच्चा HTTP काम करता है, लेकिन टाइप किया गया क्लाइंट घंटों की बचत करता है: पथ स्वत: पूर्णता, अनुरोध और प्रतिक्रिया प्रकार, 408/409/429/5xx के लिए बनाए गए रीट्री और स्टेनलेस-स्टाइल त्रुटि श्रेणी। हम तीन आधिकारिक SDK - @astroway/sdk (npm), astroway (PyPI), astroway/sdk (Packagist) - की जांच करते हैं और यह कैसे एक ओपनएपीआई अनुबंध से उत्पन्न होते हैं।
पढ़ें →Free Astrology API: Which One Has the Best Free Tier in 2026?
A side-by-side of free tiers across the major astrology APIs - credits, request caps, card requirements - and how much you can actually build for free.
पढ़ें →Horoscope API Tutorial: Build a Daily Horoscope Feature
Add daily, weekly and monthly horoscopes to your app via API - sign-based text vs transit-based personalization - with TypeScript and Python code.
पढ़ें →