curl "https://api.occultapi.com/api/astro/ayanamsa_value/" \
-H "X-API-Key: $OCCULT_API_KEY"अयनांश सायन और निरयन राशिचक्र के बीच का अंतर है। सायन राशिचक्र विषुव से बँधा है, जबकि वैदिक ज्योतिष का निरयन राशिचक्र तारों से। यह अंतर हर साल लगभग पचास विकला बढ़ता है, इसलिए हर निरयन गणना इस पर टिकी है कि आप कौन-सा अयनांश अपनाते हैं और किस तारीख़ के लिए। यह एंडपॉइंट वही एक संख्या लौटाता है। यह क्वेरी पैरामीटर वाला GET है: `ayanamsa` में LAHIRI, RAMAN, KRISHNAMURTI या TRUE_CITRA जैसा कोई नाम (47 मानक अयनांश परिभाषाएँ स्वीकार हैं, केस-असंवेदी), और `date` में ISO तारीख़, जिसका डिफ़ॉल्ट आज है। कुंडली पर यह लिखना हो कि वह किस अयनांश से बनी है, या यह देखना हो कि किसी जन्म की तारीख़ पर दो परिभाषाओं में कितना अंतर है, तो इसे इस्तेमाल करें। उत्तर में मान दोनों रूपों में मिलता है: `value_degrees` छह दशमलव स्थानों तक, और `degrees`, `minutes` व `seconds` के साथ तैयार `formatted` स्ट्रिंग। नाम और तय हुई तारीख़ भी वापस लौटाए जाते हैं। अनजान नाम पर, और छद्म-अयनांश 'USER' पर, 400 मिलता है।
| पैरामीटर | टाइप | उदाहरण | क्या करता है | |
|---|---|---|---|---|
| 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 मिलता है। |