सीधे सामग्री पर जाएँ
POST/api/astro/tarabala/1 क्रेडिट

ताराबल

ताराबल: सत्ताईस जन्म नक्षत्रों में से कौन-से नक्षत्र, चंद्रमा के वर्तमान गोचर नक्षत्र के हिसाब से अच्छी स्थिति में हैं। अनुकूल नक्षत्र श्रेणी के अनुसार समूहों में मिलते हैं, साथ में यह भी कि यह आकलन कब तक मान्य है - चंद्रमा लगभग हर दिन नक्षत्र बदलता है, इसलिए यह उसी दिन का उत्तर है। जिस उपयोगकर्ता का जन्म नक्षत्र पता हो, उसे यह बताने के लिए इसका इस्तेमाल करें कि आज का दिन उसके अनुकूल है या नहीं।

https://api.occultapi.com/api/astro/tarabala/
अनुरोध आज़माएँ
ताराबल का नतीजा, एक इंटरफ़ेस में
इस एंडपॉइंट का डेटा एक चालू इंटरफ़ेस में। API सिर्फ़ मान लौटाता है; उन्हें कैसे दिखाना है, यह आप तय करते हैं।

ऑथेंटिकेशन

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

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

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

फ़ील्डटाइपज़रूरीटिप्पणी
date_timestring (date-time)ज़रूरी

जिस क्षण की गणना करनी है, ISO 8601 फ़ॉर्मैट में। ऑफ़सेट या अंत में Z हमेशा लगाएँ - बिना ज़ोन वाली वैल्यू UTC नहीं, बल्कि Asia/Kolkata (UTC+05:30) मानी जाती है, और तब 200 के साथ पिछले दिन का नतीजा मिल सकता है। '2026-09-01T06:00:00Z' और '2026-09-01 06:00:00' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं।

latitudenumber (double)ज़रूरी

स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें।

min -89.9 · max 89.9

longitudenumber (double)ज़रूरी

स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा।

min -180 · max 180

timezone_as_floatnumber (double)ज़रूरी

स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए।

min -12 · max 14

keysarrayवैकल्पिक

कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें।

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

curl -X POST https://api.occultapi.com/api/astro/tarabala/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2026-09-01T06:00:00+05:30","timezone_as_float":5.5,"latitude":26.9124,"longitude":75.7873}'

उत्तर

{
  "data": {
    "tarabala": {
      "good_nakshatras": [
        "Bharani",
        "Krittika",
        "Mrigashira",
        "Punarvasu",
        "Ashlesha",
        "Purva Phalguni",
        "Uttara Phalguni",
        "Chitra",
        "Vishakha",
        "Jyeshtha",
        "Purva Ashadha",
        "Uttara Ashadha",
        "Dhanishtha",
        "Purva Bhadrapada",
        "Revati"
      ],
      "valid_until": "2026-08-31T21:53:59.999999Z",
      "good_nakshatras_tier2": [
        "Bharani",
        "Krittika",
        "Mrigashira",
        "Punarvasu",
        "Ashlesha",
        "Purva Phalguni",
        "Uttara Phalguni",
        "Chitra",
        "Vishakha",
        "Jyeshtha",
        "Purva Ashadha",
        "Uttara Ashadha",
        "Dhanishtha",
        "Purva Bhadrapada",
        "Revati"
      ],
      "tier2_valid_until": "2026-09-01T06:09:56+05:30"
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

त्रुटियाँ

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