/api/astro/ayanamsa_value/1 क्रेडिटअयनांश मान
अयनांश सायन और निरयन राशिचक्र के बीच का अंतर है। सायन राशिचक्र विषुव से बँधा है, जबकि वैदिक ज्योतिष का निरयन राशिचक्र तारों से। यह अंतर हर साल लगभग पचास विकला बढ़ता है, इसलिए हर निरयन गणना इस पर टिकी है कि आप कौन-सा अयनांश अपनाते हैं और किस तारीख़ के लिए। यह एंडपॉइंट वही एक संख्या लौटाता है। यह क्वेरी पैरामीटर वाला GET है: `ayanamsa` में LAHIRI, RAMAN, KRISHNAMURTI या TRUE_CITRA जैसा कोई नाम (47 मानक अयनांश परिभाषाएँ स्वीकार हैं, केस-असंवेदी), और `date` में ISO तारीख़, जिसका डिफ़ॉल्ट आज है। कुंडली पर यह लिखना हो कि वह किस अयनांश से बनी है, या यह देखना हो कि किसी जन्म की तारीख़ पर दो परिभाषाओं में कितना अंतर है, तो इसे इस्तेमाल करें। उत्तर में मान दोनों रूपों में मिलता है: `value_degrees` छह दशमलव स्थानों तक, और `degrees`, `minutes` व `seconds` के साथ तैयार `formatted` स्ट्रिंग। नाम और तय हुई तारीख़ भी वापस लौटाए जाते हैं। अनजान नाम पर, और छद्म-अयनांश 'USER' पर, 400 मिलता है।
https://api.occultapi.com/api/astro/ayanamsa_value/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…क्वेरी पैरामीटर (2)
ये URL में भेजे जाते हैं। जिन पर ज़रूरी न लिखा हो, वे सब वैकल्पिक हैं, और इन्हें साथ में इस्तेमाल कर सकते हैं — पहले फ़िल्टर, फिर पेज, फिर क्रम।
| पैरामीटर | टाइप | उदाहरण | क्या करता है | |
|---|---|---|---|---|
| ayanamsa | string | — | अयनांश का नाम (जैसे LAHIRI)। डिफ़ॉल्ट LAHIRI है। GET क्वेरी पैरामीटर। केस-असंवेदी, .strip.upper लगाया जाता है। डिफ़ॉल्ट 'LAHIRI' है। एफ़ेमेरिस इंजन 'USER' को पहचानता है, फिर भी यह एंडपॉइंट उसे साफ़ तौर पर अस्वीकार करता है। अनजान वैल्यू पर 400 {"error": "Unknown ayanamsa..."} मिलता है। इनमें से एक: FAGAN_BRADLEY, LAHIRI, DELUCE, RAMAN, USHASHASHI, KRISHNAMURTI, DJWHAL_KHUL, YUKTESHWAR, JN_BHASIN, BABYL_KUGLER1, BABYL_KUGLER2, BABYL_KUGLER3, BABYL_HUBER, BABYL_ETPSC, ALDEBARAN_15TAU, HIPPARCHOS, SASSANIAN, GALCENT_0SAG, J2000, J1900, B1950, SURYASIDDHANTA, SURYASIDDHANTA_MSUN, ARYABHATA, ARYABHATA_MSUN, SS_REVATI, SS_CITRA, TRUE_CITRA, TRUE_REVATI, TRUE_PUSHYA, GALCENT_COCHRANE, GALCENT_RGILBRAND, GALCENT_MULA_WILHELM, ARYABHATA_522, BABYL_BRITTON, TRUE_MULA, GALALIGN_MARDYKS, TRUE_SHEORAN, GALEQU_TRUE, GALEQU_MULA, GALEQU_IAU1958, GALEQU_FIORENZA, VALENS_MOON, LAHIRI_1940, LAHIRI_VP285, KRISHNAMURTI_VP291, LAHIRI_ICRC | |
| date | string | — | ISO तारीख़ स्ट्रिंग (जैसे 1990-05-14)। डिफ़ॉल्ट आज की तारीख़ है। यह फ़ॉर्मैट की शर्त है, enum नहीं। Python का datetime.fromisoformat जो कुछ भी स्वीकार करे, वह चलेगा: 'YYYY-MM-DD' या पूरा ISO 8601 datetime, जैसे '1990-05-14' / '1990-05-14T12:30:00'। स्ट्रिंग में दिया गया समय क्षेत्र ऑफ़सेट हटा दिया जाता है और उसकी जगह UTC मान लिया जाता है। डिफ़ॉल्ट आज (UTC) है। अमान्य फ़ॉर्मैट पर 400 मिलता है। |
उदाहरण अनुरोध
curl "https://api.occultapi.com/api/astro/ayanamsa_value/" \
-H "X-API-Key: $OCCULT_API_KEY"उत्तर
{
"ayanamsa": "LAHIRI",
"date": "2026-09-07",
"value_degrees": 24.229844,
"degrees": 24,
"minutes": 13,
"seconds": 47,
"formatted": "24°13'47\""
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।