POST/api/astro/part-of-fortune/1 क्रेडिट

पुण्य सहम (Part of Fortune)

पुण्य सहम (Part of Fortune), कुंडली के सेक्ट के हिसाब से सही सूत्र से निकाला गया। ज्योतिष में सबसे ज़्यादा माँगा जाने वाला सहम, और वही जिसमें सेक्ट का सबसे ज़्यादा महत्व है: day birth Ascendant + Moon - Sun night birth Ascendant + Sun - Moon इन दोनों में सूर्य-चंद्रमा की दूरी के दोगुने का अंतर होता है — आमतौर पर दसियों अंश, और अक्सर राशि ही बदल जाती है। सेक्ट किसी ऐसे फ़्लैग से तय नहीं होता जिसे आपको ख़ुद निकालना पड़े, बल्कि जन्म के क्षण पर सूर्य की असली ऊँचाई से तय होता है (सूर्य क्षितिज के ऊपर हो तो दिवा कुंडली); फिर भी आप `sect` से इसे बदल सकते हैं। चुने गए मान के साथ दोनों मान हमेशा लौटाए जाते हैं, और उन्हें बनाने वाले लग्न, सूर्य और चंद्रमा भी, ताकि फ़ैसले की जाँच की जा सके। ध्यान दें कि रात्रि जन्म के लिए इसका नतीजा /api/astro/sahams/ के पुण्य सहम से अलग होगा। वह एंडपॉइंट हर कुंडली पर दिन वाला सूत्र लगाता है; यह शास्त्रीय उत्तर देता है।

https://api.occultapi.com/api/astro/part-of-fortune/

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

ऑथेंटिकेशन

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

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

curl -X POST https://api.occultapi.com/api/astro/part-of-fortune/ \
  -H "X-API-Key: $OCCULT_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{"date_time":"1990-05-10T19:55:00+05:30","latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"sect":"auto"}'

उत्तर

{
  "data": {
    "point": "part_of_fortune",
    "also_known_as": "punya_saham",
    "zodiac": "sidereal",
    "ayanamsa": "lahiri",
    "sect": "night",
    "sect_detected": "night",
    "sect_source": "auto",
    "sun_altitude_deg": -11.186639,
    "longitude": 29.064531,
    "sign": "Aries",
    "sign_index": 1,
    "degree_in_sign": 29.0645,
    "formula": "ascendant + sun - moon",
    "day_formula_longitude": 46.248663,
    "night_formula_longitude": 29.064531,
    "components": {
      "ascendant": 217.656597,
      "sun": 25.94216,
      "moon": 214.534226
    }
  },
  "status": 200,
  "is_error": false,
  "message": "successful"
}

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

त्रुटियाँ

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