बदलावों की सूची

मुद्दा दशा

मुद्दा दशा की वर्तनी अब सही है, और यह /api/astro/mudda-dasha/ पर है, ताजिक और वर्षफल वाले हिस्से में मुंथा के पास। पुराना /api/astro/muddha_dasha/ हटा दिया गया है। नया एंडपॉइंट ग्रहों के नंबर और ऐसी तारीख़-स्ट्रिंग नहीं लौटाता जिसके अंदर अंशों की डिक्शनरी हो; वह स्वामियों के नाम और हर अवधि की शुरुआत ISO टाइमस्टैम्प में लौटाता है।

• POST /api/astro/mudda-dasha/

किसकी जगह क्या

ताजिक दृष्टियाँ: /api/astro/tajaka/ की जगह /api/astro/tajika/aspects/ इस्तेमाल करें। ताजिक योग: /api/astro/tajaka_yoga/ की जगह /api/astro/tajika/yogas/। सहम: /api/astro/saham/ की जगह /api/astro/sahams/। प्रश्नावली: /api/astro/chakra/ की जगह /api/astro/prashnavali/ वाले चार एंडपॉइंट। गुण मिलान: /api/astro/gun-milan/ की जगह /api/astro/ashtakoota/, `compatibility_score` key के साथ — यह वही तेरह मान लौटाता है (आठों कूटों के अंक, 36 में से कुल अंक और दक्षिण भारत की चार जाँचें)। षड्बल: /api/astro/shadbala/ की जगह /api/astro/strength/। नक्षत्र और राशि दशाएँ: /api/nakshatra_dasha/ और /api/raasi_dasha/ की जगह /api/astro/dasha/nakshatra/ और /api/astro/dasha/rashi/। ग्रहण: कच्चे /api/astro/eclipse/ की जगह नाम वाले सात /api/astro/eclipse/ एंडपॉइंट। KP: /api/astro/krishnamurti/ की जगह /api/astro/kp-chart/।

अगर आप हटाए गए एंडपॉइंट को कॉल करें

इनमें से किसी को भी API कुंजी से कॉल करने पर अब 403 endpoint_not_allowed मिलता है, और कोई क्रेडिट नहीं कटता। ऊपर दिए नए एंडपॉइंट पर जाएँ; SDK और Postman कलेक्शन पहले से उन्हीं को इस्तेमाल करते हैं।

• POST /api/astro/muddha_dasha/
• POST /api/astro/tajaka/
• POST /api/astro/tajaka_yoga/
• POST /api/astro/saham/
• POST /api/astro/chakra/
• POST /api/astro/gun-milan/
• POST /api/astro/shadbala/
• POST /api/nakshatra_dasha/
• POST /api/raasi_dasha/
• POST /api/astro/eclipse/
• POST /api/astro/krishnamurti/

क्या बदला

प्रसिद्ध लोगों की सूची और किसी एक व्यक्ति की जानकारी वाला एंडपॉइंट, दोनों अब उपलब्ध नहीं हैं। API कुंजी से किसी को भी कॉल करने पर 403 endpoint_not_allowed मिलता है, और कोई क्रेडिट नहीं कटता। बाकी हर एंडपॉइंट पहले जैसा है। अगर आपने इन एंडपॉइंट से जन्म का ब्योरा सहेजा था, तो उसे अब भी किसी दूसरे जन्म-डेटा की तरह कुंडली वाले एंडपॉइंट पर भेज सकते हैं।

• GET /api/astro-data/celebrities/
• GET /api/astro-data/celebrities/{id}/

जामक्कोल प्रश्न

प्रश्न के समय की स्थानीय घड़ी का समय, जगह और उसका UTC ऑफ़सेट भेजें। आपको मिलते हैं: आठ जाम ग्रह, उदयम, आरूढ़म और कविप्पु, दिन या रात का जामम, कुलिगन, एमकंडम, मृत्यु और राहु समय, ग्रह, और उस पल का पंचांग। अगर प्रश्नकर्ता राशि चुनता है तो arudam_sign भेजें; न भेजें तो आरूढ़म घड़ी से लिया जाता है। jamakkol.com से 20 से ज़्यादा कुंडलियों पर मिलाकर जाँचा गया; उस साइट से हूबहू मिलान के लिए ayanamsa true_citra और मध्यम राहु भेजें।

• POST /api/astro/prashna/jamakkol/

अष्टमंगल प्रश्न

समय और जगह भेजें, प्रश्नकर्ता की चुनी आरूढ़ राशि, और कौड़ियाँ — तीन ढेरियों के रूप में या तीन अंकों की संख्या के रूप में। आपको मिलते हैं: आरूढ़, छत्र, प्रश्न क्रिया की छह राशियाँ और हर राशि से जुड़ा अंग, पाँच सूत्र, लग्न और आरूढ़ दोनों से ग्रह, और संख्या का पूरा फल, एक-एक अंक करके। स्फुट यहाँ दोबारा नहीं दिए जाते: उसी पल के लिए /api/astro/prashna/ को कॉल करके वे लें।

• POST /api/astro/prashna/ashtamangala/

क्या बदला

ये सभी एंडपॉइंट अपना request serializer /api/astro/panchanga/ के साथ साझा करते हैं — वही एक एंडपॉइंट जो सच में पचास से ज़्यादा पंचांग keys की गणना करता है, और जिसे वे सारे इनपुट चाहिए जो ये keys मिलकर इस्तेमाल करती हैं। एक-काम वाले एंडपॉइंट को फिर भी पूरी फ़ील्ड सूची विरासत में मिल गई थी। इसलिए /day-night-length/, जो सिर्फ़ सूर्योदय-सूर्यास्त का हिसाब है, ये तेरह फ़ील्ड डॉक्स में दिखाता और स्वीकार करता था: gulika_rises_at, gulika_portion, mandi_rises_at, mandi_portion, kala_mrityu_rise_at और dhuma_vyatipata_relation (छाया-बिंदुओं की सेटिंग), samvata_type और mode (युग/गणना के स्विच), और mean_anomaly, eccentricity, eccentric_anomaly, tolerance और nakshatras — और इनमें से एक को भी उसकी अपनी गणना कभी नहीं पढ़ती थी। अब हर एंडपॉइंट सिर्फ़ वही फ़ील्ड दिखाता और स्वीकार करता है जो उसकी अपनी गणना सच में इस्तेमाल करती है: /samvat/ में samvata_type रहा, /lunar-month/ में mode, /upagraha/ में गुलिक/मांदि/काल-मृत्यु/धूम-व्यतीपात वाले छह फ़ील्ड, और बाकी 26 में इन तेरह में से कोई नहीं।

• POST /api/astro/panchang/
• POST /api/astro/rahu-kaal/
• POST /api/astro/choghadiya/
• POST /api/astro/hora/
• POST /api/astro/auspicious-timings/
• POST /api/astro/inauspicious-timings/
• POST /api/astro/vasa-segments/
• POST /api/astro/lunar-phase/
• POST /api/astro/day-night-length/
• POST /api/astro/sankranti/
• POST /api/astro/tithi/
• POST /api/astro/nakshatra/
• POST /api/astro/nitya-yoga/
• POST /api/astro/karana/
• POST /api/astro/abhijit-muhurat/
• POST /api/astro/brahma-muhurat/
• POST /api/astro/amrit-kaal/
• POST /api/astro/durmuhurat/
• POST /api/astro/disha-shool/
• POST /api/astro/muhurta-table/
• POST /api/astro/sandhya/
• POST /api/astro/panchak/
• POST /api/astro/samvat/
• POST /api/astro/lunar-month/
• POST /api/astro/tarabala/
• POST /api/astro/chandrabala/
• POST /api/astro/lagna/
• POST /api/astro/bhava-cusps/
• POST /api/astro/upagraha/

यह क्यों ज़रूरी है

किसी एंडपॉइंट के संदर्भ पेज पर दिखा फ़ील्ड यह दावा करता है कि उसे सेट करने से कुछ होता है। पर कुछ नहीं होता था: /day-night-length/ को gulika_rises_at भेजना हमेशा चुपचाप अनदेखा हो जाता था। यह फ़ील्ड के न होने से भी बुरा है — इससे कोई ऐसी सेटिंग को ठीक करने में समय लगा सकता है जो जवाब कभी बदल ही नहीं सकती। अब हर एंडपॉइंट के पेज पर ठीक वही सेटिंग हैं जो उसी एंडपॉइंट के नतीजे पर असर डालती हैं, उससे ज़्यादा कुछ नहीं।

कुछ नहीं टूटता

इन एंडपॉइंट की गणना इन फ़ील्ड को कभी पढ़ती ही नहीं थी, इसलिए इन्हें डॉक्स और स्कीमा से हटाने से किसी एंडपॉइंट का व्यवहार नहीं बदलता। अगर आपका इंटीग्रेशन इनमें से कोई फ़ील्ड पहले से, मान लीजिए /day-night-length/ को, भेजता है, तो अनुरोध अब भी सफल होता है और उत्तर वही रहता है — इसे जारी करने से पहले हर प्रभावित एंडपॉइंट पर पहले और बाद की कॉल मिलाकर जाँचा गया। फ़र्क़ सिर्फ़ इतना है कि संदर्भ पेज और SDK के बने हुए टाइप अब ऐसी सेटिंग नहीं दिखाते जिसने कभी कुछ किया ही नहीं।

क्या बदला

चौदह ब्लॉक: पंचांग, राहु काल, चौघड़िया, अभिजित और ब्रह्म मुहूर्त, दुर्मुहूर्त, एकादशी/अमावस्या/पूर्णिमा/प्रदोष/संकष्टी चतुर्थी की तारीख़ें, त्योहार कैलेंडर, राशिफल और कुंडली फ़ॉर्म। हर एक असली block editor ब्लॉक है, जिसे किसी भी core ब्लॉक की तरह inserter से खींचकर डाला जाता है, और जो लोग अब भी Classic Editor पर हैं उनके लिए हर ब्लॉक का shortcode भी है।

यह क्यों ज़रूरी है

जिसने कभी PHP की एक लाइन नहीं लिखी, वह साइट मालिक भी अपनी साइट पर लाइव पंचांग विजेट उतनी ही देर में लगा सकता है जितनी देर में एक ब्लॉक खींचकर API कुंजी चिपकाई जाती है। यह उन्हीं एंडपॉइंट के ऊपर एक पतली परत है जिनका ज़िक्र इस सूची में दूसरी जगह है — इसकी अपनी कोई गणना नहीं, इसलिए यह API से कभी अलग नतीजा नहीं दे सकता।

षोडशवर्ग के सोलहों भागों का अब अपना रूट — 8 नए

D1 राशि, D4 चतुर्थांश, D16 षोडशांश, D20 विंशांश, D24 चतुर्विंशांश, D27 नक्षत्रांश, D40 खवेदांश और D45 अक्षवेदांश, पहले से प्रकाशित आठ (D2, D3, D7, D9, D10, D12, D30, D60) के साथ जुड़ गए हैं। कोई नई गणना नहीं हो रही — /api/astro/chart/ chart_name देकर इन्हें हमेशा से बना सकता था, और ये रूट उसी view पर जाते हैं, इसलिए अंक बनावट से ही एक जैसे हैं। बदला यह है कि अब इन्हें ढूँढा जा सकता है: /navamsa/ नाम का रूट खोज में मिल जाता है, पर अनुरोध की बॉडी में छिपा chart_name नहीं मिलता। /api/astro/rashi/ वही view है, जिसमें कुंडली पहले से तय है, और यह /api/astro/planet-positions/ से बाइट-दर-बाइट एक जैसा आउटपुट देता है — एक टेस्ट ठीक यही जाँचता है, इसलिए दोनों में कभी अंतर नहीं आ सकता।

• POST /api/astro/rashi/
• POST /api/astro/chaturthamsa/
• POST /api/astro/shodasamsa/
• POST /api/astro/vimsamsa/
• POST /api/astro/chaturvimsamsa/
• POST /api/astro/nakshatramsa/
• POST /api/astro/khavedamsa/
• POST /api/astro/akshavedamsa/

षोडशवर्ग के बाहर के चार भाग — 4 नए

D5 पंचमांश (यश और अधिकार), D6 षष्ठांश (स्वास्थ्य और शत्रु), D8 अष्टमांश (आयु और अचानक होने वाली घटनाएँ) और D11 रुद्रांश (लाभ)। ये शास्त्रीय सोलह के साथ इस्तेमाल होते हैं, उनका हिस्सा नहीं हैं, और हर उत्तर यह बात बताता है। D11 के बारे में जानने लायक बात: दो परंपराएँ इसे उलटी दिशाओं में पढ़ती हैं — एक लाभ के लिए, जैसा ग्यारहवाँ भाव सुझाता है, दूसरी रुद्र के लिए, यानी विनाश। हम आपकी ओर से कोई एक नहीं चुनते।

• POST /api/astro/panchamsa/
• POST /api/astro/shashthamsa/
• POST /api/astro/ashtamsa/
• POST /api/astro/rudramsa/

D60 से आगे — 3 नए

D81 नवनवांश, D108 अष्टोत्तरांश और D144 द्वादशद्वादशांश। ये संयुक्त भाग हैं, और इंजन हर एक को दो तरह से पढ़ता है: राशि को सीधे 81, 108 या 144 भागों में बाँटकर, और वर्ग का वर्ग लेकर। ये रूट संयुक्त वाला रूप देते हैं, क्योंकि हर नाम का शाब्दिक अर्थ यही है — नव-नवांश यानी नवांश का नवांश, द्वादश-द्वादशांश यानी द्वादशांश का द्वादशांश। सीधे बँटवारे वाला रूप अब भी /api/astro/chart/ से NavnavamsaChart, AstottaramsaChart और DwadasdwadasamsaChart के रूप में मिलता है, और ज़्यादातर ग्रहों के लिए अलग राशि देता है — ये अलग-अलग कुंडलियाँ हैं, एक ही कुंडली के दो नाम नहीं। एक टेस्ट जाँचता है कि दोनों सचमुच अलग हैं, इसलिए यह चुनाव ग़लती से उलट नहीं सकता। हर भाग 22, 17 और 12 कला का है, इसलिए इन्हें तभी पढ़ना ठीक है जब जन्म का समय सचमुच मिनट तक पता हो; उससे कम सटीकता में ये बस आपके जन्म प्रमाणपत्र की गोलाई दिखाते हैं।

• POST /api/astro/navnavamsa/
• POST /api/astro/astottaramsa/
• POST /api/astro/dwadasdwadasamsa/

डॉक्स में अब भाग के क्रम से

संदर्भ हर समूह को वर्णमाला के क्रम में रखता था, जिससे D10, D2 से पहले और D144, D16 से पहले आ जाता था। इस गड़बड़ी से शृंखला अधूरी लगती थी, भले ही वह अधूरी न हो, क्योंकि D20 ढूँढने वाले को पता ही नहीं चलता था कि कहाँ देखे। अब वर्ग कुंडलियाँ जहाँ भी सूची में हों, भाग की संख्या के क्रम से आती हैं।

पहले से मौजूद कुछ नहीं बदला

पंद्रहों नए रूट हैं, जो chart_name तय कर देते हैं और बाकी काम उसी view को सौंपते हैं जो पहले से /api/astro/planet-positions/ चलाता है। /api/astro/chart/ अब भी हर वह chart_name लेता है जो पहले लेता था, उन वैकल्पिक गणनाओं समेत जिनका अपना रूट नहीं है — ParivrittidwayaHora, SomnathDrekkana, JagannathDrekkana वगैरह। वे जहाँ हैं वहीं रहेंगे: वे किसी ऐसे भाग के रूप हैं जिसका रूट पहले से है, और उन्हें वही माँगता है जिसे उनका नाम पता हो।

अवधि और पहलू के हिसाब से राशिफल — 6 नए

/api/astro/rashifal/ 3–4 पहलुओं का बदलता नमूना लौटाता है, और कौन-से पहलू होंगे, यह तारीख़ के साथ बदलता है — इसलिए “मेष स्वास्थ्य” जैसा पेज बन ही नहीं सकता था, क्योंकि किसी दिन नमूने में स्वास्थ्य होता ही नहीं था। ये छह हर कॉल पर हर पहलू लौटाते हैं: general, career_business, love_relationships, money_finances, health, education_student, family, travel, और दो जो मूल इंजन में कभी नहीं थे, business और professionals। सिर्फ़ एक पहलू चाहिए तो aspect भेजें — एक पहलू वाले पेज को ठीक यही रूप चाहिए। फल हर बार एक जैसे रहते हैं — एक ही राशि, अवधि, पहलू और तारीख़ पर हमेशा वही शब्द आते हैं, इसलिए पेज को कैश किया जा सकता है और रीफ़्रेश करने पर वह अपनी ही बात नहीं काटेगा। साप्ताहिक में सबसे अच्छे और कठिन दिन भी आते हैं; मासिक में गोचर, ख़ास दिन और उपाय; वार्षिक में तिमाही का अनुमान और शुभ चीज़ें। rashi और aspect में छोटे-बड़े अक्षरों से फ़र्क़ नहीं पड़ता, जैसे मौजूदा एंडपॉइंट पर।

• POST /api/astro/rashifal/daily/
• POST /api/astro/rashifal/tomorrow/
• POST /api/astro/rashifal/yesterday/
• POST /api/astro/rashifal/weekly/
• POST /api/astro/rashifal/monthly/
• POST /api/astro/rashifal/yearly/

अंक ज्योतिष की नौ पद्धतियाँ — 10 नए

कबाला किसी नाम को वृक्ष (Tree) के 22 मार्गों पर रखता है, हर मार्ग के हिब्रू अक्षर और टैरो ट्रंप के साथ। जेमाट्रिया हिब्रू पाठ के अंक पाँच सिफ़र से निकालता है (standard, gadol, ordinal, katan, atbash)। टैरो जन्म, साथी और नाम के पत्ते देता है; I Ching, King Wen के 64 में से जन्म और नाम के हेक्साग्राम; सेफ़ेरियल अपनी 1920 वाली तालिका, ग्रह-स्वामियों के साथ; कीरो कैल्डियन तालिका, जिसे संयुक्त अंक तक पढ़ा जाता है। अबजद और आइसोप्सेफ़ी अरबी और ग्रीक के अंक निकालते हैं, पुराने अंक-अक्षरों समेत — digamma, koppa, sampi। इनमें से तीन किसी ख़ास लिपि के लिए हैं: अबजद अरबी के लिए, आइसोप्सेफ़ी ग्रीक के लिए, जेमाट्रिया हिब्रू के लिए। गलत लिपि भेजने पर ये लिप्यंतरण नहीं करते, बल्कि 0 लौटाते हैं और हर अक्षर को unscored में डाल देते हैं, क्योंकि हर स्रोत अलग ढंग से लिप्यंतरण करता है, और मनमाने चुनाव से निकला पक्का-सा अंक एक साफ़ दिखते शून्य से बुरा है।

• POST /api/astro/numerology/kabbalah/
• POST /api/astro/numerology/gematria/
• POST /api/astro/numerology/tarot/
• POST /api/astro/numerology/iching/
• POST /api/astro/numerology/sepharial/
• POST /api/astro/numerology/abjad/
• POST /api/astro/numerology/isopsephy/
• POST /api/astro/numerology/angel/
• POST /api/astro/numerology/aura/
• POST /api/astro/numerology/cheiro/

लाल किताब के भाव, ग्रह और कुंडली का ढाँचा — 3 नए

वही स्थिर-भाव वाली परंपरा जिसके दो रूट कल जुड़े थे, अब उन तीन रूपों में जिनसे पेज सच में बनता है। /horoscope/ कुंडली को बारह राशि-खानों के रूप में देता है, और हर ग्रह का उसकी राशि के अंदर अंश। /houses/ हर भाव का स्वामी देता है, वे ग्रह जिनका वह पक्का घर है, और वहाँ कौन उच्च या नीच है — pakka_ghar एक सूची है, क्योंकि बुध और शुक्र दोनों का 7वाँ, मंगल और शनि दोनों का 8वाँ, और गुरु और राहु दोनों का 12वाँ भाव पक्का घर है, और एक अकेला मान इनमें से एक को छोड़ देता। /planets/ हर ग्रह की स्थिति-बल (dignity) और स्वभाव देता है। चंद्रमा और बुध का स्वभाव तय नहीं, गणना से निकलता है — चंद्रमा का उसके पक्ष से, बुध का इससे कि उसकी राशि में कोई नैसर्गिक पाप ग्रह है या नहीं — और हर पंक्ति में nature_basis बताता है कि फ़ैसला किस नियम से हुआ। जानने लायक बात: राहु और केतु का position तब तक null रहता है जब तक वे उच्च या नीच न हों। वे किसी राशि के स्वामी नहीं हैं, इसलिए “मित्र की राशि” मापने के लिए कोई आधार ही नहीं है।

• POST /api/astro/lal-kitab/horoscope/
• POST /api/astro/lal-kitab/houses/
• POST /api/astro/lal-kitab/planets/

जिनका जवाब हम अब भी नहीं देते

लाल किताब के ऋण और लाल किताब दशा जान-बूझकर नहीं दिए गए, और न ही वे soya और kismat फ़ील्ड जो दूसरे विक्रेता अपने houses एंडपॉइंट पर लौटाते हैं। आठों ऋणों के नाम सभी स्रोतों में एक जैसे हैं; पर हर ऋण किन स्थितियों में बनता है, इस पर सहमति नहीं — अकेले पितृ ऋण के प्रकाशित नियम इतने अलग हैं कि एक ही कुंडली के अलग-अलग जवाब निकलते हैं। सोया के साथ भी यही बात है। किसी के पूर्वजों के बारे में सिक्का उछालकर फ़ैसला सुनाने से अच्छा है कि हम कुछ न लौटाएँ, इसलिए ये फ़ील्ड नहीं हैं और उत्तर में इसकी वजह लिखी है।

पहले से मौजूद कुछ नहीं बदला

उन्नीसों नए रूट हैं। /api/astro/rashifal/ अब भी वही बॉडी लेता है और वही बदलता नमूना लौटाता है। अंक ज्योतिष की नौ नई पद्धतियाँ अपना अलग मॉड्यूल हैं, /api/astro/numerology/ पर नए मान नहीं, इसलिए मौजूदा system और keys फ़ील्ड जस के तस हैं। कीरो, कैल्डियन अक्षर-तालिका और संयुक्त अंकों के वे अर्थ दोबारा लिखने के बजाय वही इस्तेमाल करता है जो API में पहले से थे।

तैयार PDF रिपोर्ट — 2 नए

उत्तर की बॉडी ही PDF है। न दूसरा अनुरोध, न कहीं रखी फ़ाइल: हम कुछ भी नहीं सहेजते, इसलिए कोई ऐसा लिंक नहीं जिसे कोई और ढूँढ सके। इन पर .json() न चलाएँ — बाइट्स डिस्क पर लिखें (curl -o report.pdf, res.arrayBuffer(), response.content)। जन्मपत्री लगभग 27 पेज की है, अपने-आप बनी विषय-सूची के साथ। वार्षिक पुस्तिका अगले बारह महीनों को कैलेंडर के महीनों से नहीं, विंशोत्तरी प्रत्यंतर्दशा से बाँटती है, इसलिए उसके हिस्से उन तारीख़ों पर शुरू और ख़त्म होते हैं जो आपकी कुंडली तय करती है। दोनों एक वैकल्पिक ब्रांडिंग ब्लॉक लेती हैं — कंपनी का नाम, संपर्क, और logo_url, जिससे हम लोगो लाकर कवर पर छापते हैं — ताकि आपके ग्राहक को आपका नाम दिखे, हमारा नहीं। दोनों में नतीजा हर बार एक जैसा रहता है: एक ही जन्म-डेटा पर एक ही दस्तावेज़। आम तौर पर दो सेकंड से कम लगते हैं।

• POST /api/astro/pdf/horoscope/ · 25 क्रेडिट
• POST /api/astro/pdf/yearbook/ · 25 क्रेडिट

कालसर्प और कारकांश — 2 नए

कालसर्प सिर्फ़ हाँ या ना नहीं बताता, बल्कि यह भी कि कौन-से ग्रह राहु–केतु अक्ष के किस ओर पड़े — ज़्यादातर कुंडलियों में कालसर्प नहीं होता, और दोनों सूचियाँ दिखाती हैं कि कुंडली एक ग्रह से चूकी या चार से। नाम वाला रूप (अनंत, कुलिक, वासुकि …) तभी भरा जाता है जब योग सचमुच बनता हो। जानने लायक बात: /api/astro/karakamsa/ चर कारकों को राशि के अंदर के अंश से क्रम देता है, और ज़्यादातर कुंडलियों में /api/astro/chara-karakas/ से अलग आत्मकारक बताएगा। दोनों की गणना अलग ढंग से होती है और एक की जगह दूसरा नहीं चल सकता; कारकांश के काम के लिए नया वाला लें।

• POST /api/astro/kalsarp/
• POST /api/astro/karakamsa/

सर्वतोभद्र चक्र — 1 नया

नौ-गुणा-नौ का गोचर बोर्ड। ग्रहों की स्थिति के साथ पूरा ग्रिड भी लौटता है, ताकि आप उससे सिर्फ़ फ़ैसला न पढ़ें, उसे बना भी सकें — हर खाना बताता है कि उसमें क्या है, उसका छायांकन, और उसके नक्षत्र के चारों पदों के अक्षर। गोचर के ग्रहों को उसी बोर्ड पर रखने के लिए transit_date_time भेजें; तब hits_natal उन ग्रहों की सूची देता है जिनका वेध आपकी जन्म कुंडली के किसी नक्षत्र पर पड़ता है। सिर्फ़ स्थिति वाला वेध लगाया जाता है, और हर उत्तर में rule यही बताता है, क्योंकि परंपराएँ अलग हैं और बिना बताया जवाब जाँचा नहीं जा सकता। जिस नक्षत्र की वर्तनी हम पहचान न पाएँ, वह छोड़ा नहीं जाता, unplaced में लौटाया जाता है।

• POST /api/astro/sarvatobhadra/

लाल किताब — 2 नए

उत्तर भारत की एक अलग परंपरा, और इसके बारे में पहली बात यह है कि लाल किताब में भाव राशियों से बँधे होते हैं — हर कुंडली में भाव 1 हमेशा मेष है, और इसी तरह भाव 12 हमेशा मीन। किसी ग्रह का भाव उसकी राशि की संख्या है, इसलिए लगभग हर किसी के लिए ये /api/astro/chart/ और /api/astro/planet-positions/ से अलग होंगे। यह पद्धति ही ऐसी है, कोई त्रुटि नहीं। हर ग्रह के साथ उसका पक्का घर आता है, और यह कि वह उसमें बैठा है या नहीं। वर्षफल खगोलीय नहीं, अंकगणित है: उम्र का हर पूरा साल होने पर हर ग्रह एक भाव आगे बढ़ता है, इसलिए हर बारहवें साल वार्षिक कुंडली फिर जन्म कुंडली जैसी हो जाती है।

• POST /api/astro/lal-kitab/chart/
• POST /api/astro/lal-kitab/varshphal/

प्लेग्राउंड अब फ़ाइल सौंप सकता है

जो एंडपॉइंट फ़ाइल लौटाता है, उसे चलाने पर अब बाइट्स को पाठ की तरह दिखाने की कोशिश नहीं होती; फ़ाइल का नाम, टाइप और आकार एक Download बटन के साथ दिखता है। ऐसे एंडपॉइंट के संदर्भ पेज भी अब डीकम्प्रेस और पार्स करने को नहीं कहते — वह बात gzip वाले JSON रूट की थी, और PDF के लिए गलत थी।

पहले से मौजूद कुछ नहीं बदला

गणना वाले पाँचों एंडपॉइंट नए रूट हैं, जो काम उन्हीं views को सौंपते हैं जो पहले से /api/astro/planet-positions/ और वर्ग कुंडलियाँ चलाते हैं, इसलिए उनके अंक बनावट से ही एक जैसे हैं। PDF रिपोर्ट अंदर उन्हीं एंडपॉइंट को कॉल करके बनती हैं — पेज 3 पर छपी स्थितियाँ ठीक वही हैं जो /api/astro/planet-positions/ लौटाता है — और पूरी रिपोर्ट का शुल्क एक कॉल का लगता है, उन पच्चीस का नहीं जिनसे वह बनती है।

शर्त वाली नक्षत्र दशाएँ — 7 नए

ग्रह पर आधारित: उत्तर में हर स्वामी एक ग्रह है। सातों शर्त वाली हैं — शास्त्र इन्हें तभी लागू करते हैं जब कुंडली कोई ख़ास शर्त पूरी करे, इसलिए किसी को फलादेश के रूप में देने से पहले /api/astro/dasha_applicability/ जाँच लें।

• POST /api/astro/dasha/dwadashottari/
• POST /api/astro/dasha/panchottari/
• POST /api/astro/dasha/sataabdika/
• POST /api/astro/dasha/chaturaseeti-sama/
• POST /api/astro/dasha/dwisaptati/
• POST /api/astro/dasha/shattrimsa-sama/
• POST /api/astro/dasha/budhi-gati/

जैमिनी राशि दशाएँ — 15 नए

राशि पर आधारित: यहाँ हर स्वामी एक राशि है, ग्रह नहीं। यही फ़र्क़ ध्यान रखना है — यहाँ lord फ़ील्ड का मतलब ऊपर की नक्षत्र दशाओं से अलग तरह की चीज़ है, और गलत तरह से पढ़ने पर ऐसा आउटपुट मिलता है जिसका कोई अर्थ नहीं निकाल पाएँगे।

• POST /api/astro/dasha/drig/
• POST /api/astro/dasha/nirayana-shoola/
• POST /api/astro/dasha/shoola/
• POST /api/astro/dasha/sthira/
• POST /api/astro/dasha/trikona/
• POST /api/astro/dasha/brahma/
• POST /api/astro/dasha/chakra/
• POST /api/astro/dasha/kendradhi/
• POST /api/astro/dasha/lagnamsaka/
• POST /api/astro/dasha/mandooka/
• POST /api/astro/dasha/navamsa/
• POST /api/astro/dasha/paryaaya/
• POST /api/astro/dasha/sandhya/
• POST /api/astro/dasha/tara-lagna/
• POST /api/astro/dasha/yogardha/

पूरे वृक्ष की जगह एक शाखा — 1 नया

levels तय करता है कि दशा का उत्तर कितना गहरा जाए, पर उस गहराई तक की हर अवधि फिर भी लौटती है: विंशोत्तरी पर levels=3 का मतलब है हर महादशा की हर अंतर्दशा की हर प्रत्यंतर्दशा — मापने पर 95 KB। {"lords": ["moon", "mars"], "levels": 1} भेजें, तो सिर्फ़ उस एक अंतर्दशा के अंदर की अवधियाँ मिलती हैं, लगभग 1.8 KB। इससे डेटा भेजने और पार्स करने का बोझ घटता है, गणना का नहीं।

• POST /api/astro/dasha/drill/

ज्योतिष चैट — 1 नया

जन्म का ब्योरा और एक सवाल भेजें, और जवाब सीधी भाषा में पाएँ — साथ में वे शास्त्रीय अंश जिन पर जवाब टिका है, हर एक संदर्भ और अंक के साथ, ताकि तर्क जाँचा जा सके। जन्म का ब्योरा किसी खाते से नहीं, आपके अनुरोध से आता है, इसलिए आप अपने किसी भी उपयोगकर्ता की ओर से पूछ सकते हैं। अनुकूलता के सवालों के लिए compare_with जोड़ें, और history में पिछली बीस बारियाँ तक भेजें। दो कॉल के बीच कुछ नहीं सहेजा जाता। शुल्क 1 नहीं, 25 क्रेडिट है, क्योंकि हर जवाब के लिए गणना की गई कुंडली पर एक भाषा मॉडल चलता है; विफल या ख़ाली जवाब पर कुछ नहीं लगता।

• POST /api/astro/chat/ · 25 क्रेडिट

तीस दशा पद्धतियाँ, अब परिवार के हिसाब से

इनके साथ अब तीस पद्धतियों के नाम वाले एंडपॉइंट हैं, पहले आठ के थे — बाकी तक सिर्फ़ /api/nakshatra_dasha/ या /api/raasi_dasha/ को एक स्ट्रिंग देकर पहुँचा जा सकता था, इसलिए “narayana dasha” खोजने पर कुछ नहीं मिलता था। संदर्भ में अब ये पैंतीस की एक वर्णमाला वाली सूची में नहीं, तीन समूहों में हैं — नक्षत्र (ग्रह), राशि (जैमिनी), और टूल। पुरानी सूची ब्रह्मा दशा को बुद्धि गति दशा के बगल में रख देती थी।

पहले से मौजूद कुछ नहीं बदला

/api/nakshatra_dasha/ और /api/raasi_dasha/ को छुआ नहीं गया, और पहले से मौजूद आठों दशा एंडपॉइंट ठीक पहले की तरह चलते हैं — हर नया रूट काम उसी मूल view को सौंपता है, इसलिए अंक बनावट से ही एक जैसे हैं, किसी कॉपी से नहीं जो कभी खिसक जाए। चैट एंडपॉइंट ऐप के मौजूदा /api/ai/ रूट से अलग है, और वे जस के तस हैं।

क्या नया है

POST /api/astro/prashnavali/ram-shalaka/ राम शलाका प्रश्नावली की 225 चौपाइयाँ लौटाता है — हर एक के साथ उसका देवनागरी अक्षर, चौपाई, रामचरितमानस में उसकी जगह, और अंग्रेज़ी में उत्तर। /api/astro/prashnavali/hanuman/ 49 क्रमांकित उत्तर लौटाता है, /api/astro/prashnavali/sai/ साईं के 720 उत्तर, और /api/astro/prashnavali/mavji/ मावजी महाराज के 64 फल, हिंदी और अंग्रेज़ी में। संदर्भ में चारों अवतार चक्र नाम की नई श्रेणी में रखे गए हैं।

तीन बातें जो ये करते हैं और मूल एंडपॉइंट नहीं करता

फ़िल्टर हर जगह वैकल्पिक है। /api/astro/chakra/ बिना संख्या वाले sai_prashnavali अनुरोध को लौटा देता है; ये एंडपॉइंट उसकी जगह पूरा सेट लौटाते हैं, और प्रश्नावली का डेटा आम तौर पर ऐसे ही इस्तेमाल होता है — एक बार लाओ, कैश करो, अपने पास इंडेक्स करो। प्रविष्टियाँ स्ट्रिंग बनाई गई संख्या वाली keys के ऑब्जेक्ट में नहीं, एक सूची में आती हैं और हर प्रविष्टि के साथ उसका क्रमांक होता है, ताकि आप स्ट्रिंग keys को संख्या की तरह छाँटे बिना क्रम से चल सकें (वरना क्रम 1, 10, 100, 11 हो जाता है)। और हर उत्तर में count होता है, इसलिए पेलोड खोले बिना पता चल जाता है कि यह एक प्रविष्टि की खोज थी या पूरा सेट।

पहले से मौजूद कुछ नहीं बदला

/api/astro/chakra/ को छुआ नहीं गया। वह अब भी अपने keys फ़ील्ड के पीछे चारों डेटासेट देता है, अब भी वही {key: data} रूप लौटाता है, और अब भी बिना संख्या वाले sai_prashnavali पर 400 देता है। अगर आपका इंटीग्रेशन पहले से उस पर चलता है, तो इसका आप पर कोई असर नहीं — ये अतिरिक्त रूट हैं, उसकी जगह लेने वाले नहीं।

संदर्भ में बदले गए नाम

"KP (Krishnamurti) chart" और "Krishnamurti paddhati" अब "KP chart (cusps, signs and planets)" और "KP parts (pick with keys)" हैं — पहला पूरी कुंडली देता है, दूसरे में आपको वे हिस्से बताने होते हैं जो चाहिए। "House lord placements" और "House lord placement", जिनमें बस एक अक्षर का फ़र्क़ था, अब "(all 144)" और "(one pair)" हैं। "Pancha Pakshi" नाम के दो एंडपॉइंट अब "(bird activity by hora)" और "(day in ten yamas)" हैं। "Birth panchanga effects" और "Birth panchanga readings" अब "(reference table)" और "(your elements)" हैं।

रूट नहीं बदले

ये सिर्फ़ डॉक्स में दिखने वाले नाम हैं। हर रूट, अनुरोध का हर फ़ील्ड और उत्तर का हर फ़ील्ड ठीक पहले जैसा है — आपके इंटीग्रेशन में कुछ भी नहीं बदलना। अगर आपने डॉक्स का कोई पेज बुकमार्क किया है, तो उसका URL अब भी चलता है; बस ऊपर का नाम ज़्यादा साफ़ है।

संदर्भ पेजों पर स्क्रीनशॉट

43 एंडपॉइंट पेजों पर अब उस एंडपॉइंट के डेटा का स्क्रीनशॉट है, किसी चालू इंटरफ़ेस में दिखाया हुआ — पंचांग, चौघड़िया, त्योहार कैलेंडर, वक्री ग्रह, ग्यारह क्षेत्रीय कैलेंडर, जन्म कुंडलियाँ और भी बहुत कुछ। फ़ील्ड की तालिका उत्तर का ढाँचा तो बताती है, पर यह नहीं कि वह किस काम का है, और एक नज़र में आम तौर पर तय हो जाता है कि आपको यही एंडपॉइंट चाहिए या नहीं। डॉक्स के मुख्य पेज और होमपेज पर भी यही स्क्रीनशॉट हैं।

क्या बदला

/api/astro/chart/ अब एक वैकल्पिक render फ़ील्ड लेता है। इसे न भेजें तो कुछ नहीं बदलता — उत्तर ठीक वैसा ही रहता है जैसा हमेशा था। इसे "svg" पर सेट करें तो सामान्य चार फ़ील्ड के साथ दो और आते हैं: layout (हर भाव या राशि-खाने के बहुभुज के बिंदु, लेबल की जगह, और उसमें कौन-से ग्रह हैं) और svg (तैयार markup, जिसे सीधे पेज में डाल सकते हैं)। chart_style से उत्तर भारतीय (हीरे वाली, भाव स्थिर, राशियाँ घूमती हुई) या दक्षिण भारतीय (स्थिर राशि-ग्रिड, भाव घूमते हुए) शैली चुनें; svg_size, theme, label_style, show_degrees और *_color वाले चार फ़ील्ड तय करते हैं कि वह कैसी दिखे।

यह क्यों ज़रूरी है

कच्चे भोगांशों से कुंडली-चक्र बनाना सच में मेहनत का काम है — भावों की ज्यामिति, राशियों का घुमाव, लेबल की जगह — और हर इंटीग्रेट करने वाला यह शून्य से दोहरा रहा था। अब यह उस कॉल पर बस एक फ़ील्ड है जो आप पहले से कर रहे थे। लेआउट ज्यामिति उनके लिए है जो हमारा markup लेने के बजाय React, Canvas, Flutter या SwiftUI में नेटिव रूप से बनाते हैं।

पहले से मौजूद कुछ नहीं बदला

render का डिफ़ॉल्ट "none" है, और बाकी हर नए फ़ील्ड का डिफ़ॉल्ट ऐसा मान है जो कुछ नहीं करता। जिस अनुरोध में इनमें से किसी का ज़िक्र नहीं, उसे वही उत्तर मिलता है जो इसके जारी होने से पहले मिलता था — इस एंडपॉइंट के हर कुंडली प्रकार और हर विकल्प पर बाइट-दर-बाइट मिलाकर जाँचा गया।

दशाएँ जिन्हें खोजा जा सकता है

हम तीस दशा पद्धतियों की गणना पहले से करते थे — ग्यारह नक्षत्र दशाएँ और उन्नीस राशि दशाएँ, हर एक कई स्तरों तक — पर वे nakshatra_dasha और raasi_dasha नाम के दो एंडपॉइंट पर dasha_type स्ट्रिंग के मान भर थीं। “vimshottari dasha” खोजने पर कुछ नहीं मिलता था। अब नाम वाले रूट हैं: /api/astro/dasha/vimshottari/, /yogini/, /ashtottari/, /chara/, /narayana/, /kalachakra/ वगैरह, और साथ में /api/astro/dasha/systems/, जो हर पद्धति को उसके एंडपॉइंट के साथ दिखाता है। दोनों पुराने एंडपॉइंट को छुआ नहीं गया और वे चलते रहेंगे।

अभी कौन-सी दशा चल रही है

/api/astro/dasha/current/ उस सवाल का जवाब देता है जो समय-रेखा वाले एंडपॉइंट नहीं दे पाते थे: वह महादशा से नीचे तक की पूरी कड़ी लौटाता है — “गुरु / केतु / बुध” — हर स्तर के शुरू और ख़त्म होने के समय के साथ, यह कि आप उसमें कितना आगे आ चुके हैं, और कितने दिन बचे हैं। पहले इसके लिए पूरा वृक्ष लाकर, उसमें नीचे तक जाकर, अपने कोड में तारीख़ें मिलानी पड़ती थीं।

पारंपरिक और हेलेनिस्टिक पाश्चात्य ज्योतिष

/api/astro/traditional/dignities/ हर ग्रह के लिए domicile, exaltation, triplicity, term और face लौटाता है, Lilly के स्कोर के साथ; /almuten/ कुंडली के हर बिंदु पर सबसे ज़्यादा अधिकार वाला ग्रह देता है; /sect/ बताता है कि कुंडली दिन की है या रात की, और उससे क्या निकलता है; /profections/ वार्षिक, मासिक और दैनिक profection देता है, Lord of the Year के साथ। ये सायन हैं, जैसा यह सिद्धांत माँगता है, और उत्तर बताता है कि कौन-सी bound और triplicity तालिकाएँ इस्तेमाल हुईं — स्रोत अलग-अलग हैं, और दूसरी तालिका से निकला स्कोर एक अलग संख्या होता है।

व्युत्पन्न चार्ट और चंद्रमा

/api/astro/western/ के अंतर्गत ड्रैकोनिक, हार्मोनिक, एंटीशिया, हेलियोसेंट्रिक और डेविसन चार्ट, साथ में /api/astro/lunar/void-of-course/ और /api/astro/lunar/mansions/। Void of course किसी एक पल की तस्वीर नहीं, आगे की खोज है: यह चंद्रमा के राशि बदलने तक खोजता है, हर वह दृष्टि बताता है जो पूरी होगी और ठीक कब, और बताता है कि void कब शुरू और कब ख़त्म होता है।

चीनी चार स्तंभ

/api/astro/chinese/four-pillars/, /bazi/, /zodiac/ और /luck-pillars/। चीनी वर्ष लीचुन से शुरू होता है, लगभग 4 फ़रवरी को — न 1 जनवरी को, न चीनी नव वर्ष को, जो चंद्र तिथि है और त्योहार तय करता है, कुंडली नहीं। 20 जनवरी 2024 का जन्म Water Rabbit देता है, Wood Dragon नहीं। दिन की सीमा और सही सौर समय, दोनों की परंपराएँ अनुरोध के फ़ील्ड हैं, क्योंकि ज्योतिषी इन पर अलग राय रखते हैं और हर एक से कुंडली बदलती है।

टैरो

/api/astro/tarot/draw/, /spread/, /yes-no/ और /deck/। हर बार पत्ते निकालने पर वह seed भी लौटता है जिससे वे निकले, और वही seed वापस भेजने पर ठीक वही पत्ते दोबारा निकलते हैं — वही पत्ते, वही क्रम, वही दिशा। इसी से आप कोई रीडिंग सहेजकर दोबारा दिखा सकते हैं, न कि एक ही सवाल पर पूछने वाले को अलग जवाब दे दें। छह नाम वाले स्प्रेड, दस पत्तों वाले Celtic Cross तक, हर स्थान के नाम के साथ।

और भी नया

/api/astro/eclipse/visibility-path/ बताता है कि सूर्य ग्रहण कहाँ पूर्ण दिखेगा, निर्देशांकों के रूप में जिन्हें नक्शे पर बना सकते हैं, साथ में सबसे बड़े ग्रहण का बिंदु और उसकी Saros शृंखला। नौ और एंडपॉइंट उन गणनाओं को अलग करते हैं जिनके लिए पहले यह जानना पड़ता था कि किसी बड़े एंडपॉइंट से कौन-सी keys माँगनी हैं: अष्टकवर्ग प्रस्तार और शोधन, ताजिक दृष्टियाँ और योग, ग्रहों के क्षितिज और विषुवतीय निर्देशांक, चंद्रमा की रोशनी, वास खंड और cazimi।

पहले से मौजूद कुछ नहीं बदला

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

क्या बदला

/api/astro/sunrise/, /api/astro/tithi/, /api/astro/navamsa/ और /api/astro/rahu-kaal/ जैसे एंडपॉइंट सामान्य जन्म या तारीख़ वाले फ़ील्ड लेते हैं और सिर्फ़ वही चीज़ लौटाते हैं जिसके नाम पर वे हैं। मौजूदा संयुक्त एंडपॉइंट नहीं बदले और ठीक पहले की तरह चलते रहेंगे।

यह क्यों ज़रूरी है

सूर्योदय का समय दिखाने के लिए अब पूरा पंचांग माँगना, उसका शुल्क देना और उसे पार्स करना ज़रूरी नहीं। छोटे उत्तर, कम मैपिंग कोड, और ऐसी अनुरोध बॉडी जिसे पढ़ा जा सके।

कैसे शुरू करें

संदर्भ देखें और X-API-Key हेडर में अपनी कुंजी डालकर नमूना अनुरोध भेजें। कीमत वही है: एक सफल कॉल का एक क्रेडिट, वह चाहे जो लौटाए।

क्या बदला

खोज सिर्फ़ एंडपॉइंट के नाम से नहीं, फ़ीचर से भी मिलान करती है। “manglik” लिखने पर दोष वाला एंडपॉइंट मिल जाता है, भले ही उसके नाम में “manglik” शब्द न हो, और नतीजा बताता है कि कौन-सा फ़ील्ड मिला।

यह क्यों ज़रूरी है

एंडपॉइंट की सूची के पीछे कई सौ अलग-अलग फ़ील्ड हैं। फ़ील्ड के नामों पर खोज के बिना, अपना फ़ील्ड ढूँढने के लिए एक-एक एंडपॉइंट खोलकर उनके उत्तर पढ़ने पड़ते थे।

क्या बदला

occult-api MCP सर्वर एंडपॉइंट की खोज, एंडपॉइंट के विवरण और कॉल को टूल के रूप में देता है। उसे अपनी API कुंजी दें, और असिस्टेंट सही एंडपॉइंट ढूँढकर सीधे उसे कॉल कर सकता है।

यह क्यों ज़रूरी है

कुछ भी बनाने का फ़ैसला करने से पहले किसी असली सवाल पर API आज़माने का यह सबसे तेज़ तरीक़ा है, और साथ ही यह अनुरोध के फ़ॉर्मैट का एक चलता हुआ नमूना भी है।

क्या बदला

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

यह क्यों ज़रूरी है

नमूना उत्तर पढ़कर डेटा का ढाँचा समझ आता है। अपने इनपुट भेजकर पता चलता है कि वह आपके सवाल का जवाब देता है या नहीं।

क्या बदला

साइन अप करें, कुंजी बनाएँ, और उसे X-API-Key हेडर में भेजें। क्रेडिट हर सफल कॉल पर कटते हैं — विफल अनुरोध पर कभी शुल्क नहीं लगता।

यह क्यों ज़रूरी है

हर एंडपॉइंट की अलग कीमतों वाली कोई सूची नहीं, जिसका हिसाब लगाना पड़े। गणनाएँ NASA JPL के एफ़ेमेरिस डेटा पर चलती हैं, शास्त्रीय और आधुनिक अयनांशों के पूरे सेट के साथ।