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

जन्म ग्रह पर गोचर

एक ग्रह के किसी दूसरे ग्रह की जन्म स्थिति के ऊपर से गुज़रने के पहले से लिखे फलादेश — जन्म चंद्रमा पर गोचर शनि, जन्म सूर्य पर गोचर बृहस्पति, आदि। ज़्यादातर गोचर रिपोर्टें ग्रह-से-ग्रह वाली इसी गोचर तालिका से बनती हैं। यह केवल लुकअप है, इसके पीछे कोई कुंडली गणना नहीं: गोचर ग्रह `planet` में और जन्म कुंडली का ग्रह `natal_planet` में भेजें, और पाठ मिल जाएगा। कौन-से संपर्क सचमुच बन रहे हैं, यह पहले `/api/astro/transit/` जैसी गोचर गणना से पता करें, फिर पाठ के लिए इसे कॉल करें। दोनों आर्ग्युमेंट नौ पिंड स्वीकार करते हैं, हालाँकि गोचर वाली तरफ़ शुक्र नहीं है। क्रम मायने रखता है: जन्म सूर्य पर शनि और जन्म शनि पर सूर्य, दो अलग प्रविष्टियाँ हैं।

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

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

ऑथेंटिकेशन

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

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

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

फ़ील्ड	टाइप	ज़रूरी	टिप्पणी
keys	array	ज़रूरी	कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें।
natal_planet	string	ज़रूरी	`sunmoonmarsmercuryjupitervenussaturnrahuketu` सटीक मिलान, छोटे अक्षरों में। हर गोचर ग्रह के तहत सभी 9 मौजूद हैं (मैपिंग को AST से पार्स करके जाँचा गया)। अनजान वैल्यू पर HTTP 200 के साथ "Invalid key: <x>" मिलता है।
planet	string	ज़रूरी	`sunmoonmarsmercuryjupitersaturnrahuketu` ध्यान दें: गोचर ग्रह के रूप में 'venus' गायब है - मैपिंग में शीर्ष-स्तर की केवल ये 8 keys हैं। अनजान वैल्यू पर HTTP 200 के साथ "Invalid key: <x>" मिलता है।

उपलब्ध keys (1)

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

Key	और कौन-से फ़ील्ड चाहिए	विवरण
get_planet_transit_natal_planets	planet, natal_planet	`natal_planet` की जन्म स्थिति के ऊपर से `planet` के गोचर का फलादेश। छोटे वाक्यांशों की सूची लौटाती है, आमतौर पर दो से चार, और हर वाक्यांश उस संपर्क के बारे में एक अलग बात कहता है। जोड़ी की दिशा मायने रखती है, इसलिए गोचर ग्रह और जन्म ग्रह को आपस में बदला नहीं जा सकता।

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

curl -X POST https://api.occultapi.com/api/astro/planet_transit_natal_planets/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"keys":["get_planet_transit_natal_planets"],"planet":"Sun","natal_planet":"sun"}'

उत्तर

{
  "data": {
    "get_planet_transit_natal_planets": [
      "Start of a new solar cycle",
      "Brings new energy, optimism, and enthusiasm"
    ]
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

त्रुटियाँ

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