/api/astro/tithi_scan/1 क्रेडिटतिथि का वार्षिक स्कैन
तिथि चांद्र मास का तीसवाँ भाग है — वह समय जिसमें सूर्य से चंद्रमा की कोणीय दूरी 12 अंश और बढ़ती है। लगभग हर हिंदू पर्व तिथि के आधार पर ही तय होता है, और तिथियाँ कैलेंडर दिनों से मेल नहीं खातीं: कोई तिथि लगभग उन्नीस घंटे जितनी छोटी या लगभग छब्बीस घंटे जितनी लंबी हो सकती है, इसलिए एक ही तिथि अक्सर दो तारीख़ों में फैली होती है। यह एंडपॉइंट एक तिथि लेता है और कैलेंडर वर्ष में वह जितनी बार आती है, हर बार का वास्तविक आरंभ और अंत लौटाता है। `tithi_number` 1 से 30 तक है: 1-15 शुक्ल प्रतिपदा से पूर्णिमा तक, 16-29 कृष्ण प्रतिपदा से चतुर्दशी तक, और 30 अमावस्या। `year` स्थानीय कैलेंडर वर्ष है, और `timezone_as_float` तय करता है कि वह कौन-सा स्थानीय वर्ष है (IST के लिए 5.5)। निर्देशांक नहीं चाहिए, क्योंकि तिथि पृथ्वी पर हर जगह एक ही क्षण शुरू और ख़त्म होती है। उत्तर `{year, tithi_number, rows}` है, जिसमें `rows` समय के क्रम में `{start, end}` की सूची है, UTC ISO टाइमस्टैम्प में — आमतौर पर बारह या तेरह प्रविष्टियाँ, क्योंकि कोई तिथि हर चांद्र मास में एक बार आती है। बीच में पड़ने वाले सूर्योदयों पर अवधि नहीं काटी जाती, इसलिए दो कैलेंडर दिनों में फैली तिथि एक ही पंक्ति में आती है।
https://api.occultapi.com/api/astro/tithi_scan/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| timezone_as_float | number (double) | ज़रूरी | स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। |
| tithi_number | integer | ज़रूरी | min 1 · max 30 |
| year | integer | ज़रूरी | जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में। min 1800 · max 2400 |
उदाहरण अनुरोध
curl -X POST https://api.occultapi.com/api/astro/tithi_scan/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"timezone_as_float":5.5,"tithi_number":1,"year":2026}'उत्तर
{
"data": {
"year": 2026,
"tithi_number": 1,
"rows": [
{
"start": "2026-01-18T19:52:39+00:00",
"end": "2026-01-19T20:45:19+00:00"
},
{
"start": "2026-02-17T12:01:47+00:00",
"end": "2026-02-18T11:28:41+00:00"
},
{
"start": "2026-03-19T01:24:05+00:00",
"end": "2026-03-19T23:23:24+00:00"
},
{
"start": "2026-04-17T11:52:21+00:00",
"end": "2026-04-18T08:41:36+00:00"
},
{
"start": "2026-05-16T20:01:32+00:00",
"end": "2026-05-17T16:11:46+00:00"
},
{
"start": "2026-06-15T02:54:39+00:00",
"end": "2026-06-15T23:01:51+00:00"
},
{
"start": "2026-07-14T09:44:04+00:00",
"end": "2026-07-15T06:21:58+00:00"
},
{
"start": "2026-08-12T17:37:11+00:00",
"end": "2026-08-13T15:12:30+00:00"
},
{
"start": "2026-09-11T03:27:28+00:00",
"end": "2026-09-12T02:17:22+00:00"
},
{
"start": "2026-10-10T15:50:36+00:00",
"end": "2026-10-11T16:02:05+00:00"
},
{
"start": "2026-11-09T07:02:42+00:00",
"end": "2026-11-10T08:31:14+00:00"
},
{
"start": "2026-12-09T00:52:31+00:00",
"end": "2026-12-10T03:17:14+00:00"
}
]
},
"message": "successful",
"is_error": false
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।