AstroWay API दस्तावेज़ीकरण
AstroWay API के तकनीकी दस्तावेज़ीकरण का हब। Swiss Ephemeris पर आधारित 865 एंडपॉइंट, मशीन-रीडेबल OpenAPI स्पेक, Postman और Insomnia के लिए तैयार कलेक्शन, TypeScript, Python और PHP के लिए आधिकारिक SDK, Claude/Cursor के लिए MCP सर्वर।
Reference
Section titled “Reference” API Reference 865 एंडपॉइंट का पूरा कैटलॉग: पैरामीटर, रिस्पॉन्स स्कीमा, error codes। हर रिलीज़ पर OpenAPI spec से जनरेट होता है।
OpenAPI specification मशीन-रीडेबल स्पेक। इसे Postman/Insomnia में इम्पोर्ट करें या openapi-generator से अपना SDK जनरेट करें।
Postman collection इम्पोर्ट के लिए तैयार कलेक्शन, हर एंडपॉइंट के उदाहरणों के साथ।
Per-endpoint cost हर एंडपॉइंट की क्रेडिट में लागत: 0 से 500 क्रेडिट तक।
शुरुआत
Section titled “शुरुआत” क्विक स्टार्ट रजिस्टर करें, कुंजी पाएँ और 5 मिनट में पहली कॉल करें।
ऑथेंटिकेशन X-Api-Key बनाम Bearer, live (aw_live_*) बनाम sandbox (aw_test_*), dashboard के लिए JWT।
क्रेडिट और सीमाएँ क्रेडिट पूलिंग, मासिक कोटा, प्लान के अनुसार rate limits।
भाषा समर्थन 21 सक्रिय भाषाएँ। `Accept-Language` के ज़रिए रिस्पॉन्स का स्थानीयकरण (टेक्स्ट सामग्री)।
SDK और इंटीग्रेशन
Section titled “SDK और इंटीग्रेशन” TypeScript SDK npm पर आधिकारिक पैकेज `@astroway/sdk`। ESM, Node 20+, ब्राउज़र-संगत।
Python SDK PyPI पर आधिकारिक पैकेज `astroway`। Sync और async क्लाइंट, Python 3.9+।
PHP SDK Packagist पर आधिकारिक पैकेज `astroway/sdk`। PSR-18 HTTP, PHP 8.1+।
MCP server `@astroway/mcp`: Claude Desktop, Cursor और अन्य AI एजेंटों के लिए Model Context Protocol सर्वर।
इंजीनियरिंग
Section titled “इंजीनियरिंग” गणनाओं की सटीकता Swiss Ephemeris की arc-second सटीकता। NASA Eclipse Catalog के विरुद्ध CI-snapshot टेस्ट।
त्रुटियाँ error codes और HTTP स्टेटस की सूची, तथा error envelope की संरचना।
Idempotency POST पर सुरक्षित retry के लिए `Idempotency-Key` header।
वर्ज़निंग हम वर्ज़न कैसे बढ़ाते हैं, संगतता क्या तोड़ती है, changelog कैसे पढ़ें।
परिदृश्य और उदाहरण
Section titled “परिदृश्य और उदाहरण” उत्पादों का अवलोकन चार उत्पाद समूह: Birth Chart, Human Design, Synastry, Horoscope।
वैदिक ज्योतिष Vedic के लिए 354+ एंडपॉइंट: Vargas, dashas (8 प्रणालियाँ), Panchang, Shadbala, Yogas, Doshas।
कोड उदाहरण जन्म कुंडली, सिनेस्ट्री, गोचर, Human Design और MCP के लिए तैयार स्निपेट।
Use cases ज्योतिष ऐप्स, AI एजेंटों और डेटिंग प्लेटफ़ॉर्म के लिए इंटीग्रेशन परिदृश्य।