/api/astro/pdf/yearbook/25 क्रेडिटवर्ष पुस्तिका PDF रिपोर्ट
आने वाले बारह महीने, दशा अवधियों में बँटे हुए, एक तैयार PDF के रूप में। उत्तर की बॉडी ख़ुद PDF है (`application/pdf`) — एक कॉल, और कुछ भी स्टोर नहीं होता। /api/astro/pdf/horoscope/ एक जन्म कुंडली का वर्णन करता है; यह उसी कुंडली के एक वर्ष का। कुंडली रिपोर्ट आज बनाएँ या दस वर्ष बाद, दस्तावेज़ वही रहता है; यह रिपोर्ट एक तारीख़ से बँधी है और समय के साथ पुरानी पड़ जाती है — अगले वर्ष फिर बनाएँ, तो हर पेज अलग होगा। वर्ष कैलेंडर महीनों में नहीं बँटा है। यह विंशोत्तरी प्रत्यंतर्दशा — दशा वृक्ष के तीसरे स्तर — के हिसाब से बँटा है, इसलिए हर खंड उसी तारीख़ पर शुरू और ख़त्म होता है जो यह कुंडली तय करती है। इसलिए कोई अवधि तीन सप्ताह की भी हो सकती है और दो महीने की भी, और पहली व अंतिम अवधि आमतौर पर बारह महीनों की सीमा से बाहर तक जाती है, क्योंकि अवधि या तो पूरी छपती है या बिल्कुल नहीं। हर अवधि को वित्त, करियर, पारिवारिक जीवन, प्रेम और वैवाहिक जीवन, और स्वास्थ्य के पहलुओं से पढ़ा जाता है, साथ में क्या करें, किससे बचें, और उस अवधि के ग्रह के पारंपरिक उपाय। कोई अवधि सहायक होगी या कठिन, यह इसी कुंडली में स्वामी ग्रह की गरिमा, भाव और कार्यात्मक स्वभाव से तय होता है, और फ़ैसले के साथ उसके आधार भी छपे होते हैं — इसलिए एक ही शुक्र अवधि से गुज़र रहे दो लोगों को एक जैसा पेज नहीं मिलता। डिटर्मिनिस्टिक। हर पैराग्राफ़ तय तालिका से लिया जाता है, जनरेट नहीं किया जाता: एक ही जन्म विवरण और एक ही `start_date` से बाइट-दर-बाइट एक जैसी पुस्तिका बनती है, और इसी वजह से सहायता से जुड़े सवालों का उत्तर दिया जा सकता है। `start_date` का डिफ़ॉल्ट आज है। लगातार खिसकने वाली बारह महीने की पुस्तिका के बजाय जन्मदिन से जन्मदिन तक की पुस्तिका चाहिए, तो जातक का अगला जन्मदिन भेजें। कुंडली रिपोर्ट वाला ही जन्म विवरण और वही वैकल्पिक `branding` ब्लॉक लेता है। दो उत्तर हेडर देखने लायक हैं: `X-Report-Periods` बताता है कि वर्ष कितनी दशा अवधियों में बँटा, ताकि पुस्तिका खोले बिना पता चल जाए कि वह पूरी है या अधूरी, और `X-Report-Sections-Failed` उन गणनाओं को गिनता है जो पूरी नहीं हो सकीं।
https://api.occultapi.com/api/astro/pdf/yearbook/ऑथेंटिकेशन
अपनी कुंजी X-API-Key हेडर में भेजें। कुंजी सिर्फ़ सर्वर पर रखने की चीज़ है — इसे कभी ब्राउज़र के JavaScript या मोबाइल ऐप में न डालें।
X-API-Key: yt_live_a1b2c3d4_…
Content-Type: application/jsonअनुरोध के फ़ील्ड
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| latitude | number (double) | ज़रूरी | स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -90 · max 90 |
| longitude | number (double) | ज़रूरी | स्थान का देशांतर, दशमलव अंशों में। पूर्वी देशांतर धनात्मक होता है, पश्चिमी ऋणात्मक। उदाहरण: जयपुर के लिए 75.7873, न्यूयॉर्क के लिए -74.0060। चिह्न पर ध्यान दें: माइनस छूट गया, तो न्यूयॉर्क चीन में पहुँच जाएगा। min -180 · max 180 |
| ayanamsa | string | वैकल्पिक | |
| branding | object | वैकल्पिक | कवर, हेडर और फ़ुटर पर छपने वाला रीसेलर विवरण। |
| 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' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं। |
| day | integer | वैकल्पिक | महीने का दिन, संख्या के रूप में (1-31)। min 1 · max 31 |
| gender | string | वैकल्पिक | |
| hour | integer | वैकल्पिक | जन्म का घंटा, 24 घंटे वाले रूप में (0-23)। जन्म स्थान का स्थानीय समय। min 0 · max 23 |
| minute | integer | वैकल्पिक | min 0 · max 59 |
| month | integer | वैकल्पिक | जन्म का महीना, संख्या के रूप में (1-12)। जनवरी 1 है। min 1 · max 12 |
| name | string | वैकल्पिक | |
| place | string | वैकल्पिक | |
| start_date | string (date) | वैकल्पिक | जिन बारह महीनों की पुस्तिका चाहिए, उनका पहला दिन, YYYY-MM-DD। डिफ़ॉल्ट आज की तारीख़ है। लगातार खिसकने वाली बारह महीने की पुस्तिका के बजाय जन्मदिन से जन्मदिन तक की पुस्तिका चाहिए, तो जातक का अगला जन्मदिन भेजें। |
| timezone_as_float | number (double) | वैकल्पिक | स्थान का UTC ऑफ़सेट, घंटों में, दशमलव संख्या के रूप में। उदाहरण: भारत के लिए 5.5 (UTC+05:30), सर्दियों में न्यूयॉर्क के लिए -5, नेपाल के लिए 5.75। इसका date_time से मिलान नहीं किया जाता - दोनों में मेल न हो, तब भी उत्तर सफल आएगा, पर गलत क्षण का। इसलिए दोनों एक ही स्रोत से लें। उस तारीख़ को लागू ऑफ़सेट दें, आज का नहीं: डेलाइट सेविंग वाले देश में गर्मियों में हुए जन्म के लिए गर्मियों का ऑफ़सेट चाहिए। min -12 · max 14 |
| year | integer | वैकल्पिक | जन्म का वर्ष, संख्या के रूप में, जैसे 1990। चार अंकों में। min 1800 · max 2200 |
उदाहरण अनुरोध
curl -X POST https://api.occultapi.com/api/astro/pdf/yearbook/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"name":"Ajeet Kanojia","gender":"male","date_time":"1985-02-23T05:45:00+05:30","latitude":20.8833,"longitude":76.2,"timezone_as_float":5.5,"place":"Malkapur, Maharashtra, India","start_date":"2026-01-01","branding":{"company_name":"Acme Astrology","company_info":"Vedic reports since 2011.","company_email":"hello@acme.example","domain_url":"https://acme.example","footer_link":"acme.example"}}'उत्तर
त्रुटियाँ
कुंजी और क्रेडिट की जाँच से आई त्रुटियाँ { "error": "…", "message": "<code>", "is_error": true } रूप में आती हैं। लोगों को error दिखाएँ और कोड में message देखकर फ़ैसला करें। पूरी सूची त्रुटि संदर्भ में है।