POST/api/astro/attributes/1 क्रेडिट

कुंडली के गुणधर्म

कुंडली की बारह छोटी-छोटी गणनाएँ, एक ही कॉल में — ऐसी चीज़ें, जिनके लिए वरना आपको दर्जन भर अनुरोध भेजने पड़ते। आप कुछ भी भेजें, यह हमेशा बारहों की गणना करता है। इनमें शामिल हैं: किसी भोगांश का नक्षत्र और पद, नाम से किसी नक्षत्र की संख्या और स्वामी ग्रह, राशि के भीतर किसी भोगांश का हद्दा (मिस्री term) स्वामी, कक्ष्या स्वामी और कक्ष्या संख्या, किसी भोगांश की राशि, दिए गए क्षण पर कौन-से ग्रह अस्त हैं, चंद्रमा का कला-कोण, चुनी गई चंद्र कला अगली बार कब होगी, किसी वर्ष के चार ऋतु-प्रवेश क्षण, और किसी भोगांश से निकाली गई वर्ग कुंडली की स्थिति। केवल `date_time` ज़रूरी है; बाकी सबका डिफ़ॉल्ट है (भोगांश 0, नाम 'Ashwini', राशि 'Aries', स्वामी 'saturn', अमावस्या के लिए target_phase 0, limitdays 30, चालू वर्ष, राशि कुंडली के लिए chart_factor 1), इसलिए केवल `date_time` और `longitude` वाली छोटी-सी कॉल से ही अस्त ग्रह, चंद्र कला, नक्षत्र और राशि मिल जाते हैं। दो अटपटी बातें: `lord` का मिलान केस-संवेदी है, और डेटा में Mercury बड़े अक्षर से लिखा है, इसलिए 'mercury' पर बिना त्रुटि के null मिलता है, जबकि 'Mercury' पर संख्या; और `when` व `nakshatras` अनुरोध फ़ील्ड स्वीकार तो होते हैं, पर कभी पढ़े नहीं जाते।

https://api.occultapi.com/api/astro/attributes/

अनुरोध आज़माएँ

ऑथेंटिकेशन

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

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

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

फ़ील्ड	टाइप	ज़रूरी	टिप्पणी
date_time	string (date-time)	ज़रूरी	जिस क्षण की गणना करनी है, ISO 8601 फ़ॉर्मैट में। ऑफ़सेट या अंत में Z हमेशा लगाएँ - बिना ज़ोन वाली वैल्यू UTC नहीं, बल्कि Asia/Kolkata (UTC+05:30) मानी जाती है, और तब 200 के साथ पिछले दिन का नतीजा मिल सकता है। '2026-09-01T06:00:00Z' और '2026-09-01 06:00:00' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं। यह फ़ॉर्मैट की शर्त है, enum नहीं। DRF DateTimeField: केवल ISO-8601 (DRF के डिफ़ॉल्ट इनपुट फ़ॉर्मैट), जैसे "2026-09-01T06:00:00+05:30", "2026-09-01T06:00:00Z" या "2026-09-01 06:00:00" (समय क्षेत्र न हो, तो UTC माना जाता है)।
chart_factor	integer	वैकल्पिक	dasavarga_from_longitude के लिए वर्ग कुंडली का गुणक (1=Rashi, 9=Navamsa, आदि)।
limitdays	integer	वैकल्पिक	search_moon_phase के लिए खोज की अवधि, दिनों में।
longitude	number (double)	वैकल्पिक	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180
lord	string	वैकल्पिक	get_kakshya_number में इस्तेमाल होने वाला स्वामी ग्रह। `saturnjupitermarssunvenusMercurymoonascendant` केस-संवेदी, सटीक मिलान। डेटा ख़ुद एक जैसा नहीं है: सात नाम छोटे अक्षरों में हैं, पर Mercury बड़े अक्षर से 'Mercury' लिखा है, इसलिए 'mercury' पर बिना त्रुटि के null मिलता है, जबकि 'Mercury' पर 6। मेल न खाने वाली वैल्यू पर कोई त्रुटि नहीं आती, बस null मिलता है। डिफ़ॉल्ट 'saturn'।
nakshatras	string	वैकल्पिक
name	string	वैकल्पिक	get_nakshatra_details में इस्तेमाल होने वाला नक्षत्र का नाम। `AardraAasreshaAbhijitAnooraadhaAnuradhaArdraAshleshaAshwiniBharaniChitraDhanishtaDhanishtha` `nakshatra_details` के नतीजे के लिए नक्षत्र का नाम। केस-असंवेदी, आगे-पीछे के स्पेस हटा दिए जाते हैं। आधुनिक वर्तनियाँ (Mrigashira, Ardra, Pushya, Ashlesha, Magha, Purva Phalguni, Swati, Vishakha, Anuradha, Purva Ashadha, Uttara Ashadha, Shravana, Dhanishta, Shatabhisha, Purva Bhadrapada, Uttara Bhadrapada) और इंजन के पुराने लिप्यंतरण (Mrigasira, Aardra, Pushyami, Aasresha, Makha, Poorva Phalguni, Swaati, Visaakha, Anooraadha, Poorvaashaadha, Uttaraashaadha, Sravanam, Dhanishtha, Satabhishak, Poorvaabhaadra, Uttaraabhaadra), दोनों चलते हैं। 'Abhijit' भी स्वीकार है (28-नक्षत्र पद्धति)। डिफ़ॉल्ट 'Ashwini'।
target_phase	integer	वैकल्पिक	कौन-सी चंद्र कला खोजनी है: 0=अमावस्या, 1=प्रथम चतुर्थांश, 2=पूर्णिमा, 3=अंतिम चतुर्थांश।
when	string	वैकल्पिक
year	integer	वैकल्पिक	जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में।
zodiac	string	वैकल्पिक	get_hadda_lord में इस्तेमाल होने वाली राशि। `AriesTaurusGeminiCancerLeoVirgoLibraScorpioSagittariusCapricornAquariusPisces`

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

curl -X POST https://api.occultapi.com/api/astro/attributes/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"2024-11-21T07:45:44.368Z","longitude":76.125,"name":"Ashwini","zodiac":"Aries","lord":"saturn","target_phase":0,"limitdays":30,"year":1,"chart_factor":1}'

उत्तर

{
  "data": {
    "nakshatra_pada": [
      "Aardra",
      3
    ],
    "nakshatra_details": [
      1,
      "Ketu"
    ],
    "hadda_lord": null,
    "kakshya_lord": "venus",
    "kakshya_number": 1,
    "zodiac_name": "Gemini",
    "combust_planets": {
      "Mars": false,
      "Mercury": false,
      "Venus": false,
      "Jupiter": false,
      "Saturn": false
    },
    "moon_phase": 250.14160858923307,
    "search_moon_phase": "2024-12-01T06:22:06Z",
    "seasons": {
      "spring_equinox": "0001-03-20T21:39:01Z",
      "summer_solstice": "0001-06-22T20:51:18Z",
      "autumnal_equinox": "0001-09-23T07:34:54Z",
      "winter_solstice": "0001-12-21T00:14:00Z"
    },
    "dasavarga_from_longitude": {
      "constellation": 2,
      "longitude": 16.125
    },
    "get_nakshatra_name": "Aardra"
  },
  "message": "successful",
  "is_error": false
}

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

त्रुटियाँ

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