POST/api/astro/combustion/1 क्रेडिट

अस्त की अवधियाँ

जब कोई ग्रह सूर्य के इतना पास हो कि दिखाई न दे, तो उसे अस्त कहते हैं — asta, यानी 'set' — और शास्त्रीय ग्रंथ मानते हैं कि वह जल गया है और अपना फल नहीं दे सकता। यह एंडपॉइंट किसी एक ग्रह की वे सभी अस्त अवधियाँ लौटाता है, जो दिए गए कैलेंडर वर्ष से ज़रा भी मेल खाती हों। जाँच सीधी कोणीय दूरी की है। सूर्य से ग्रह की भूकेंद्रीय कोणीय दूरी जब तक उस ग्रह के अपने ऑर्ब से कम रहे, ग्रह अस्त है: मंगल के लिए 17°, मार्गी बुध के लिए 14° और वक्री बुध के लिए 12°, मार्गी शुक्र के लिए 10° और वक्री शुक्र के लिए 8°, बृहस्पति के लिए 11° और शनि के लिए 15°। वर्ष को दोनों सिरों पर थोड़ा आगे-पीछे तक स्कैन किया जाता है, क्योंकि कोई अवधि नए साल के आर-पार फैली हो सकती है, और फिर हर सीमा को द्विभाजन (bisection) से सटीक किया जाता है। `planet` (mars, mercury, venus, jupiter या saturn) और `year` भेजें। उत्तर `{planet, year, periods, total_asta_days_in_year}` है। इसमें हर अवधि के साथ `start`, `end`, पूरी अवधि का `duration_days`, और उसके उस हिस्से का `days_in_year` होता है, जो आपके पूछे वर्ष में पड़ता है। कोणीय दूरी इस पर निर्भर नहीं करती कि आप कहाँ हैं, इसलिए समय हर जगह एक ही रहते हैं; `timezone_as_float` बस यह तय करता है कि उन्हें किस समय क्षेत्र में दिखाया जाए।

https://api.occultapi.com/api/astro/combustion/

अनुरोध आज़माएँ

अस्त की अवधियाँ का नतीजा, एक इंटरफ़ेस में — इस एंडपॉइंट का डेटा एक चालू इंटरफ़ेस में। API सिर्फ़ मान लौटाता है; उन्हें कैसे दिखाना है, यह आप तय करते हैं।

ऑथेंटिकेशन

अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।

X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/json

अनुरोध के फ़ील्ड

फ़ील्ड	टाइप	ज़रूरी	टिप्पणी
planet	string	ज़रूरी	`marsmercuryvenusjupitersaturn`
year	integer	ज़रूरी	जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में। min 1800 · max 2400
latitude	number (double)	वैकल्पिक	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें।
longitude	number (double)	वैकल्पिक	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा।
timezone_as_float	number (double)	वैकल्पिक	स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। min -12 · max 14

उदाहरण अनुरोध

curl -X POST https://api.occultapi.com/api/astro/combustion/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"planet":"mars","year":2026,"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5}'

उत्तर

{
  "data": {
    "planet": "mars",
    "year": 2026,
    "periods": [
      {
        "start": "2025-11-06T23:51:13.853078",
        "end": "2026-03-26T14:07:06.209182",
        "duration_days": 139.6,
        "days_in_year": 84.6
      }
    ],
    "total_asta_days_in_year": 84.6
  },
  "message": "successful",
  "is_error": false
}

ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।

त्रुटियाँ

कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।