/api/astro/planet_transit_over_house/1 क्रेडिटभाव पर गोचर
जन्म कुंडली के किसी भाव से गुज़रते ग्रह के पहले से लिखे फलादेश: तीसरे भाव से सूर्य का गुज़रना क्या फल देता माना जाता है, सातवें से शनि का गुज़रना क्या, आदि — नौ ग्रहों के लिए, बारहों भावों में। केवल लुकअप — `planet` और `house` भेजें और पाठ पाएँ। इसमें तारीख़, समय या स्थान की कोई भूमिका नहीं, इसलिए इसे किसी ऐसी गणना के साथ इस्तेमाल करें जो बताए कि इस समय हर ग्रह किस भाव में है। इसे `/api/astro/planet_transit_natal_planets/` के साथ इस्तेमाल करें, जो गोचर रिपोर्ट का बाकी आधा हिस्सा देता है: गोचर ग्रह का किसी भाव से नहीं, किसी जन्म ग्रह से संपर्क।
https://api.occultapi.com/api/astro/planet_transit_over_house/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| house | integer | ज़रूरी | |
| keys | array | ज़रूरी | कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। |
| planet | string | ज़रूरी | sunmoonmarsmercuryjupitervenussaturnrahuketuसटीक मिलान, छोटे अक्षरों में। अनजान वैल्यू पर HTTP 200 के साथ "Invalid key: <x>" मिलता है। (साथी `house` फ़ील्ड एक सूची में पूर्णांक इंडेक्स है, 0 से शुरू (zero-based) - __main__ उदाहरण देखें। |
उपलब्ध keys (1)
आपको जो गणनाएँ चाहिए, बस उन्हीं के नाम keys में लिखें। कोई एक भी अनजान नाम हुआ तो पूरा अनुरोध लौटा दिया जाता है। आप कितनी भी गणनाएँ माँगें, शुल्क 1 क्रेडिट ही लगता है — इसलिए सब एक साथ माँगें।
| Key | और कौन-से फ़ील्ड चाहिए | विवरण |
|---|---|---|
| get_planet_transit_over_house | planet, house | `house` में दिए गए भाव से `planet` के गोचर का फलादेश। छोटे वाक्यांशों की सूची लौटाती है, आमतौर पर दो से चार, और हर वाक्यांश उस गोचर के बारे में एक अलग बात कहता है। |
उदाहरण अनुरोध
curl -X POST https://api.occultapi.com/api/astro/planet_transit_over_house/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"keys":["get_planet_transit_over_house"],"planet":"Sun","house":3}'उत्तर
{
"data": {
"get_planet_transit_over_house": [
"Irritable temper",
"Gains physical strength, fame, and honour"
]
},
"status": 200,
"is_error": false,
"message": "successful"
}ऊपर वाले अनुरोध से ही की गई असली कॉल का उत्तर। नतीजे data के अंदर हैं, हर नतीजा उसी नाम से जिससे आपने माँगा।
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।