फ़ील्ड के फ़ॉर्मैट

• URL — बेस https://api.occultapi.com, फिर रूट ठीक वैसा जैसा सूची में है, आख़िर में स्लैश के साथ।
  सही: /api/astro/tithi/, /api/astro/dasha/vimshottari/, /api/festivals/।
  गलत: /api/astro/tithi, /astro/tithi/, /api/astro/Tithi/।
• ऑथेंटिकेशन — आपकी कुंजी X-API-Key हेडर में, और हर POST पर Content-Type: application/json।
• मेथड — JSON बॉडी के साथ POST। गिने-चुने GET अनुरोध (जगह की खोज, अयनांश का मान, शलाका बोर्ड और प्राकृतिक आपदाओं का डेटा) अपने इनपुट, अगर कोई हो, क्वेरी पैरामीटर में लेते हैं।
  सही: JSON बॉडी के साथ POST /api/astro/panchanga/; GET /api/astro/geocode/?address=Jaipur।

• date_time — ISO 8601 में, UTC ऑफ़सेट या आख़िर में Z के साथ। यह वह पल है जिसकी गणना करनी है (जन्म कुंडली के लिए जन्म का पल)।
  सही: "1990-08-15T10:30:00+05:30", "2026-09-01T00:30:00Z"।
  गलत: "1990-08-15 10:30:00" (ऑफ़सेट नहीं है: ज़्यादातर एंडपॉइंट इसे UTC+05:30 मानते हैं, कुछ UTC), "15/08/1990 10:30 AM"।
• datetime — वही मान, बस दूसरे नाम से। /api/astro/chart/, वर्ग कुंडली के रूट और /api/astro/planet-positions/ यही वर्तनी माँगते हैं; दशा के रूट दोनों में से कोई भी ले लेते हैं।
• date और time — सिर्फ़ /api/astro/date_time/ पर। यह स्थानीय घड़ी का समय और निर्देशांक लेकर उस तारीख़ का ऑफ़सेट वाला टाइमस्टैम्प लौटाता है।
  सही: "1990-08-15" और "10:30:00"।
• year, month, day — सादे पूर्णांक, जहाँ एंडपॉइंट इन्हें माँगे (अंक ज्योतिष, कैलेंडर, साल भर की खोज)।
  सही: 1990, 8, 15।

• latitude / longitude — दशमलव अंशों में। उत्तर और पूर्व धनात्मक, दक्षिण और पश्चिम ऋणात्मक।
  सही: 26.9124, 75.7873 (जयपुर); 40.7128, -74.006 (न्यूयॉर्क)।
  गलत: "26°54′N", स्ट्रिंग, या न्यूयॉर्क के लिए 74.006 (माइनस छूटने से वह चीन पहुँच जाता है)।
• timezone_as_float — घंटों में UTC ऑफ़सेट, -12 से 14 के बीच की संख्या के रूप में। वही ऑफ़सेट जो उस तारीख़ को उस जगह लागू था (गर्मियों का समय भी गिनकर)।
  सही: 5.5 (भारत), -4 (गर्मियों में न्यूयॉर्क), 5.75 (नेपाल)।
  गलत: "+05:30", "Asia/Kolkata", "IST"।
• कुछ एंडपॉइंट पर इसी ऑफ़सेट का नाम अलग है: timezone (जैसे /api/astro/dosha/ और /api/astro/strength/), tz (/api/astro/transit/) और time_zone (/api/astro/celestial/)। वही नाम भेजें जो एंडपॉइंट की सूची में है।

• ayanamsa (निरयन एंडपॉइंट) — अयनांश का नाम, छोटे-बड़े अक्षरों से फ़र्क़ नहीं पड़ता; डिफ़ॉल्ट LAHIRI। /api/astro/chart/ पर यह ज़रूरी है।
  सही: LAHIRI, KRISHNAMURTI, RAMAN, TRUE_CITRA।
  गलत: "kp-newcomb", "Lahiri ayanamsa"। /api/astro/chart/ पर अनजान नाम भेजने से 400 मिलता है।
• /api/astro/western/ और /api/astro/return/ रूट पर ayanamsa का डिफ़ॉल्ट TROPICAL है; निरयन स्थिति चाहिए तो किसी अयनांश का नाम भेजें।
• जिस एंडपॉइंट में ayanamsa फ़ील्ड नहीं है, वह लाहिड़ी से गणना करता है। /api/astro/prashna/jamakkol/ की अपनी छोटे अक्षरों वाली सूची है: lahiri, true_citra, krishnamurti, raman।

• keys — JSON सूची, जिसमें एंडपॉइंट की keys तालिका के हूबहू नाम हों।
  सही: /api/astro/panchanga/ पर ["tithi", "vaara", "rahu_kaalam"]।
  गलत: "tithi,vaara" (एक स्ट्रिंग), "Tithi", "rahu_kaal"।
• कुछ keys को एक और फ़ील्ड चाहिए, जो keys तालिका में लिखा है: /api/astro/numerology/ पर phone_number key के लिए phone_number का मान भी भेजना होता है।
• जिस एंडपॉइंट के संदर्भ में keys तालिका नहीं है, जैसे /api/astro/tithi/ या /api/astro/rahu-kaal/, वह हमेशा एक ही गणना करता है; उसे keys भेजने की ज़रूरत नहीं।

• /api/astro/chart/ पर chart_name — PascalCase में, छोटे-बड़े अक्षर मायने रखते हैं। एक कॉल में कई कुंडलियाँ चाहिए तो सूची भेजें।
  सही: "RashiChart", ["RashiChart", "NavamsaChart", "DasamsaChart"]।
  गलत: "rashi", "D9", "Navamsa"।
• notation — छोटे अक्षरों में degree (दशमलव अंश) या astrological (राशि, अंश, कला, विकला)।
• राहु-केतु (चंद्र पात) — कुंडली के रूट पर rahu (डिफ़ॉल्ट true, या mean या both), दशा और जैमिनी के रूट पर node (डिफ़ॉल्ट true, या mean), Human Design और प्रश्न पर node_type (डिफ़ॉल्ट mean, पर /api/astro/prashna/ पर यह ज़रूरी है)।
• /api/astro/western/house-cusps/ पर house_system — छोटे अक्षरों में, शब्दों के बीच अंडरस्कोर।
  सही: placidus (डिफ़ॉल्ट), whole_sign, equal, koch, porphyry, regiomontanus, campanus, topocentric।
  गलत: "whole-sign", "W"।
• राशिफल के रूट पर rashi — राशियों के अंग्रेज़ी नाम।
  सही: aries, taurus, … pisces।
• /api/astro/numerology/ पर system — chaldean (डिफ़ॉल्ट), pythagorean, chinese या vedic। हर पद्धति की अपनी keys हैं।
• /api/astro/tarot/spread/ पर spread — three_card (डिफ़ॉल्ट), one_card, celtic_cross, horseshoe, relationship या situation।
• /api/astro/numerology/angel/ पर sequence — जो संख्या दिखी, स्ट्रिंग के रूप में।
  सही: "1111", "444"।
  गलत: 1111 (संख्या के रूप में)।
• दशा की समय-रेखा पर levels — 1 से 4, डिफ़ॉल्ट 3: 1 पर सिर्फ़ महादशाएँ, 2 पर अंतर्दशाएँ भी, 3 पर प्रत्यंतर्दशाएँ भी।

हर रूट स्लैश पर ख़त्म होता है। स्लैश न हो तो सर्वर 301 देकर स्लैश वाले URL पर भेज देता है, और ज़्यादातर HTTP क्लाइंट उस रीडायरेक्ट पर आपकी बॉडी के बिना GET भेजते हैं, इसलिए कॉल विफल हो जाती है। रूट की वर्तनी हूबहू कॉपी करें: कुछ में हाइफ़न है (/api/astro/rahu-kaal/), कुछ में अंडरस्कोर (/api/astro/monthly_panchang/), और कुछ /api/astro/ के बाहर हैं (/api/festivals/, /api/vrat-upavas/)।

• /docs/agent-gotchas — ध्यान रखने की बातें
• /docs/agent-tasks — एजेंट के लिए झटपट सूची