/api/astro/date_time/1 क्रेडिटसमय क्षेत्र निर्धारण
घड़ी के हिसाब से लिखे जन्म समय और निर्देशांकों से एक ऐसा क्षण निकालता है, जिसमें कोई संदेह न रहे। यहाँ का हर दूसरा एंडपॉइंट या तो समय क्षेत्र वाला टाइमस्टैम्प माँगता है या UTC ऑफ़सेट की संख्या, और इसी में गलती होने से कुंडली चुपचाप एक घंटा या एक दिन खिसक जाती है। इसलिए आम तौर पर पहली कॉल यही होती है। `date`, `time`, `latitude` और `longitude` भेजें। निर्देशांकों से IANA समय क्षेत्र निकाला जाता है, बिना ज़ोन वाली तारीख़ और समय उसी ज़ोन में पढ़े जाते हैं, और आपको `input_datetime`, तय हुए `timezone` का नाम, ऑफ़सेट सहित `localized_datetime`, और `utc_datetime` मिलते हैं। स्थानीय समय वाली वैल्यू सीधे दूसरे एंडपॉइंट के `date_time` में दें। एक सावधानी: अनुरोध फ़ील्ड की वर्तनी `use_LMT` है, पर व्यू दूसरी वर्तनी वाला नाम पढ़ता है, इसलिए स्थानीय माध्य समय कभी लागू नहीं होता और हमेशा IANA ज़ोन ही लगता है — उत्तर में `use_lmt` हमेशा false रहता है। जिस जगह मानक समय बाद में अपनाया गया, वहाँ उससे पहले के जन्मों के लिए इस फ़्लैग पर भरोसा न करें; स्थानीय माध्य समय का ऑफ़सेट ख़ुद निकालें (देशांतर के हर अंश पर चार मिनट)।
https://api.occultapi.com/api/astro/date_time/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| date | string (date) | ज़रूरी | यह फ़ॉर्मैट की शर्त है, enum नहीं। डिफ़ॉल्ट इनपुट फ़ॉर्मैट वाला DRF DateField = केवल ISO-8601: 'YYYY-MM-DD'। |
| latitude | number (double) | ज़रूरी | स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -180 · max 180 |
| longitude | number (double) | ज़रूरी | स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180 |
| time | string (time) | ज़रूरी | यह फ़ॉर्मैट की शर्त है, enum नहीं। डिफ़ॉल्ट इनपुट फ़ॉर्मैट वाला DRF TimeField = केवल ISO-8601: 'HH:MM', 'HH:MM:SS' या 'HH:MM:SS.ffffff'। कैटलॉग की नमूना वैल्यू "string" भ्रम में डालती है। |
| use_LMT | boolean | वैकल्पिक | |
उदाहरण अनुरोध
curl -X POST https://api.occultapi.com/api/astro/date_time/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date":"1980-09-05","time":"04:42:05.037Z","longitude":80,"latitude":23,"use_LMT":true}'उत्तर
{
"input_datetime": "1980-09-05 04:42:05",
"latitude": 23,
"longitude": 80,
"timezone": "Asia/Kolkata",
"use_lmt": false,
"localized_datetime": "1980-09-05T04:42:05.037000+05:30",
"utc_datetime": "1980-09-04T23:12:05.037000+00:00"
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।