सीधे सामग्री पर जाएँ

झटपट शुरुआत

एक असली अनुरोध भेजें, असली उत्तर पढ़ें, फिर उसे अपने कोड में जोड़ें। विफल कॉल पर कुछ नहीं लगता।

1. कुंजी लें

खाता बनाएँ और कुंजियों वाले पेज से एक कुंजी बनाएँ। हर नए खाते में 150 मुफ़्त क्रेडिट मिलते हैं, जिन्हें आप असली कुंजी से असली API पर ख़र्च कर सकते हैं — यह अलग डेटा वाला कोई सैंडबॉक्स नहीं है।

कुंजी सिर्फ़ एक बार दिखाई जाती है और हमारे पास केवल उसका हैश रहता है, इसलिए हम उसे वापस नहीं निकाल सकते। उसे तुरंत अपने सीक्रेट मैनेजर में रखें। खो जाए तो सहायता टीम से माँगने के बजाय नई कुंजी बना लें।

2. प्लेग्राउंड में आज़माएँ

प्लेग्राउंड खोलें, अपनी कुंजी डालें, कोई एंडपॉइंट चुनें और भेजें। यहाँ आपकी अपनी कुंजी से असली API पर असली कॉल चलती हैं; विफल कॉल पर कुछ नहीं लगता। कुछ भी लिखने से पहले यह कर लें: कुछ ही सेकंड लगते हैं, और पता चल जाता है कि उत्तर में वह सब है या नहीं जो आपके प्रोडक्ट को चाहिए।

3. कॉल करें

हर अनुरोध JSON बॉडी के साथ POST होता है, और X-API-Key हेडर से ऑथेंटिकेट होता है। यह अनुरोध जयपुर का आज का पंचांग माँगता है:

curl
curl -X POST https://api.occultapi.com/api/astro/panchanga/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "date_time": "2026-09-16T06:00:00+05:30",
    "latitude": 26.9124,
    "longitude": 75.7873,
    "timezone_as_float": 5.5,
    "keys": ["tithi", "nakshatra_segments", "yogam", "karana", "vaara"]
  }'
TypeScript
const response = await fetch(
  "https://api.occultapi.com/api/astro/panchanga/",
  {
    method: "POST",
    headers: {
      "X-API-Key": process.env.OCCULT_API_KEY!,
      "Content-Type": "application/json",
    },
    body: JSON.stringify({
      date_time: "2026-09-16T06:00:00+05:30",
      latitude: 26.9124,
      longitude: 75.7873,
      timezone_as_float: 5.5,
      keys: ["tithi", "nakshatra_segments", "yogam", "karana", "vaara"],
    }),
  },
);

const body = await response.json();
if (body.is_error) throw new Error(body.message);
console.log(body.data);
Python
import os, requests

response = requests.post(
    "https://api.occultapi.com/api/astro/panchanga/",
    headers={"X-API-Key": os.environ["OCCULT_API_KEY"]},
    json={
        "date_time": "2026-09-16T06:00:00+05:30",
        "latitude": 26.9124,
        "longitude": 75.7873,
        "timezone_as_float": 5.5,
        "keys": ["tithi", "nakshatra_segments", "yogam", "karana", "vaara"],
    },
)

body = response.json()
if body["is_error"]:
    raise RuntimeError(body["message"])
print(body["data"])

4. उत्तर पढ़ें

हर उत्तर का ढाँचा एक जैसा होता है। is_error देखकर आगे बढ़ें; नतीजा data के अंदर है, उन्हीं नामों से जो आपने माँगे थे।

उत्तर
{
  "data": {
    "tithi": {
      "paksha": "Shukla",
      "name": "Panchami",
      "number": 5,
      "start_time": "2026-09-15T02:15:17Z",
      "end_time": "2026-09-16T03:30:28Z",
      "remaining_time": { "hours": 3, "minutes": 0, "seconds": 28 }
    },
    "nakshatra_segments": [
      { "name": "Vishakha", "start_time": "2026-09-15T09:51:13.999999Z", "end_time": "2026-09-16T11:52:46.999999Z" },
      { "name": "Anuradha", "start_time": "2026-09-16T11:52:46.999999Z", "end_time": "2026-09-17T14:23:53.999999Z" }
    ],
    "yogam": "Vaidhriti",
    "karana": "Balava",
    "vaara": "Mangalavara"
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

फ़ील्ड का रूप हर एंडपॉइंट में अलग होता है। संदर्भ में ज़्यादातर एंडपॉइंट पेज गढ़ा हुआ नहीं, असली कॉल से लिया गया उत्तर दिखाते हैं; जिन कुछ की जाँच अभी बाकी है, उन पर यह साफ़ लिखा है।

5. देखें कितना लगा

उत्तर के हेडर ही बता देते हैं, दूसरी कॉल की ज़रूरत नहीं:

X-Credits-Cost:      1
X-Credits-Charged:   1     # 0 on any error — you are billed for answers
X-Credits-Remaining: 149

कई अनुरोध भेजने के बजाय एक ही अनुरोध में कई keys माँगें। कीमत दोनों तरह बराबर है, इसलिए पाँच गणनाओं वाली एक कॉल पाँच अलग कॉल के पाँचवें हिस्से में पड़ती है।

जोड़-तोड़ का कोड ख़ुद नहीं लिखना चाहते?

किसी AI असिस्टेंट को हमारे MCP सर्वर से जोड़ दें। वह ख़ुद एंडपॉइंट खोज लेगा, अनुरोध का स्कीमा पढ़ लेगा और कॉल कर देगा — खोजने और डॉक्स पढ़ने पर कोई क्रेडिट नहीं लगता। अगर आप कोडिंग एजेंट के साथ काम कर रहे हैं, तो पहले उसे /agents दें। किसी भी भाषा में टाइप वाला क्लाइंट बनाने के लिए OpenAPI स्पेक इस्तेमाल करें।

आगे