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

चीनी राशि

पशु, उसका तत्व, और किसके साथ उसकी बनती है। पशु वर्ष की ब्रांच (BRANCH) से आता है और तत्व वर्ष के स्टेम (STEM) से — इसी से काष्ठ ड्रैगन पृथ्वी ड्रैगन से अलग होता है, और चक्र बारह का नहीं, साठ वर्ष का बनता है। चीनी वर्ष LICHUN से शुरू होता है — वह क्षण जब सूर्य 315 अंश सायन भोगांश पर पहुँचता है, लगभग 4 फ़रवरी को। 1 जनवरी नहीं, और चीनी नववर्ष भी नहीं; नववर्ष एक चांद्र तारीख़ है, जो 21 जनवरी से 20 फ़रवरी के बीच खिसकती रहती है और त्योहार तय करती है, चार्ट नहीं। 20 जनवरी 2024 को जन्मे व्यक्ति का स्तंभ 2023 का है: जल खरगोश, काष्ठ ड्रैगन नहीं। सस्ते इम्प्लीमेंटेशन ठीक यही गलती करते हैं, और इससे जनवरी में जन्मे हर व्यक्ति का वर्ष गलत तय हो जाता है। साथ में ये भी मिलते हैं: पशु के त्रिकोण वाली दो ब्रांच, जिन्हें परंपरा उसके स्वाभाविक साथी मानती है, और ठीक सामने वाली ब्रांच, जिससे उसका टकराव (clash) होता है। और मास व घंटे की ब्रांच से भीतरी और गुप्त पशु — वर्ष का पशु वह चेहरा है जो दूसरे देखते हैं, जबकि ये दोनों व्यक्ति के ज़्यादा क़रीब माने जाते हैं।

https://api.occultapi.com/api/astro/chinese/zodiac/

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

ऑथेंटिकेशन

अपनी कुंजी 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' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं।
day_boundary	string	वैकल्पिक	दिन का स्तंभ कब बदलता है। 'zi_hour' यानी 23:00, जो पारंपरिक नियम है; 'midnight' यानी मध्यरात्रि, जो ज़्यादातर सॉफ़्टवेयर मानते हैं। 23:00 और 24:00 के बीच हुए जन्मों के लिए दोनों के नतीजे अलग आते हैं। `zi_hourmidnight`
keys	array	वैकल्पिक	कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें।
latitude	number (double)	वैकल्पिक	स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें।
longitude	number (double)	वैकल्पिक	स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा।
orb_factor	number (double)	वैकल्पिक	सभी दृष्टियों के ऑर्ब एक साथ घटाएँ-बढ़ाएँ। 0.5 देने पर ऑर्ब आधे हो जाते हैं, 2 देने पर दोगुने। min 0.1 · max 2
timezone_as_float	number (double)	वैकल्पिक	स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। min -12 · max 14
true_solar_time	boolean	वैकल्पिक	समय क्षेत्र के याम्योत्तर से स्थान के देशांतर का जितना अंतर है, उसके हिसाब से घंटे में सुधार करें। परंपरा में वास्तविक स्थानीय सौर समय लिया जाता है, और इससे घंटे का स्तंभ एक जगह खिसक सकता है।

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

curl -X POST https://api.occultapi.com/api/astro/chinese/zodiac/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1984-06-15T14:30:00+08:00","latitude":39.9042,"longitude":116.4074,"timezone_as_float":8}'

उत्तर

{
  "data": {
    "system": "Chinese zodiac",
    "chinese_year": 1984,
    "year_begins_at_lichun": "1984-02-04T15:18:45+00:00",
    "animal": "Rat",
    "element": "wood",
    "polarity": "yang",
    "sign": "Wood Rat",
    "year_pillar": "Jia-Zi",
    "allies": [
      "Dragon",
      "Monkey"
    ],
    "clash": "Horse",
    "inner_animal": {
      "animal": "Horse",
      "from": "month branch",
      "meaning": "Traditionally read as the private self."
    },
    "secret_animal": {
      "animal": "Goat",
      "from": "hour branch",
      "meaning": "Traditionally read as the innermost self."
    },
    "note": "The animal follows the year branch and the year turns at Lichun, about 4 February. A January birth carries the PREVIOUS year's animal."
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

त्रुटियाँ

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