सोलर रिटर्न API

अनुरोध

एक असली अनुरोध: 2027 में डेमो कुंडली का रिटर्न, जन्म स्थान पर।

curl -X POST https://api.natalchart.ai/v1/solar-return \
  -H "Authorization: Bearer $NATALCHART_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"birth":{"date":"1991-09-06","time":"18:30","latitude":50.4501,"longitude":30.5234},"year":2027}'

उत्तर

उस अनुरोध के उत्तर का एक हिस्सा: मुख्य फ़ील्ड, और हर सूची उसके पहले तीन आइटम तक छोटी की गई।

{
  "year": 2027,
  "exactMomentUtc": "2027-09-06T08:29:55Z",
  "location": {
    "latitude": 50.4501,
    "longitude": 30.5234
  },
  "chart": "the full chart of that moment, in the shape of /v1/chart/full"
}

उत्तर में क्या आता है

• exactMomentUtc: वह क्षण जब सूर्य दोबारा अपने जन्म के भोगांश पर पहुँचता है, UTC में।
• location: कुंडली कहाँ के लिए बनाई गई है; जन्म स्थान, जब तक आप कोई दूसरा स्थान न भेजें।
• natalSun: जन्म के सूर्य का भोगांश, जिससे रिटर्न मापा जाता है।
• chart: उस क्षण और स्थान की पूरी कुंडली, उसी ढाँचे में जो जन्म कुंडली वाले एंडपॉइंट का है।

सीमाएँ

• सिर्फ़ API Pro पर। मुफ़्त कुंजी पर एंडपॉइंट 403 लौटाता है, साथ में अपग्रेड करने का लिंक।
• जन्म समय ज़रूरी है।
• सायन (ट्रॉपिकल) राशिचक्र और प्लेसिडस भाव, जन्म कुंडली जैसी ही सेटिंग्स।
• जन्म विवरण पढ़ा जाता है, इस्तेमाल होता है और भुला दिया जाता है: अनुरोध की सामग्री कभी संग्रहीत नहीं होती।

AI सहायक में

https://www.natalchart.ai/mcp पर MCP सर्वर के ज़रिए सहायक solar_return टूल कॉल करते हैं और आने वाले साल को गणना की गई कुंडली से पढ़ते हैं।

API का बाक़ी हिस्सा

यही कुंजी पूरा ज्योतिष API खोलती है: जन्म कुंडलियाँ, दैनिक गोचर, सिनैस्ट्री, किसी अवधि के गोचर, सोलर रिटर्न, सबसे अच्छे दिन और एस्ट्रोकार्टोग्राफी। हर एंडपॉइंट, फ़ील्ड और त्रुटि API दस्तावेज़ में है, और कीमतों वाला पेज बताता है कि अनुरोध किसे गिना जाता है।

प्रश्न