curl -X POST https://api.occultapi.com/api/astro/pancha_pakshi_hora/ \
-H "X-API-Key: $OCCULT_API_KEY" \
-H "Content-Type: application/json" \
-d '{"date_time":"2026-09-01 06:00:00","keys":["get_birth_bird_from_nakshathra","get_birth_nakshathra","get_matching_pancha_pakshi_data_from_db"],"latitude":26.9124,"longitude":75.7873,"timezone_as_float":5.5,"nakshatras":"special"}'पंच पक्षी शास्त्र एक तमिल पद्धति है, जो हर व्यक्ति को उसके जन्म नक्षत्र और पक्ष के आधार पर पाँच पक्षियों में से एक देती है — गिद्ध, उल्लू, कौआ, मुर्गा या मोर — और फिर दिन के समय को इस बात से परखती है कि वह पक्षी उस समय क्या कर रहा है। हर पक्षी बारी-बारी से पाँच गतिविधियाँ करता है — शासन, भोजन, चलना, सोना और मरना — जो इसी क्रम में कम अनुकूल होती जाती हैं। दिन का हर हिस्सा शुभ है या अशुभ, यह इससे तय होता है कि आपके पक्षी की गतिविधि का उस समय चल रही गतिविधि से क्या संबंध है। पक्षी जानने के लिए get_birth_bird_from_nakshathra इस्तेमाल करें; get_birth_nakshathra और get_paksha वे दो इनपुट लौटाती हैं जिनसे पक्षी निकलता है — गणना दिखानी हो तो ये काम आती हैं। तीनों नाम नहीं, सादे पूर्णांक लौटाती हैं। get_matching_pancha_pakshi_data_from_db उस पक्षी की कच्ची गतिविधि तालिका लौटाती है, आपके पूछे गए क्षण के वार और पक्ष के लिए: पचास संख्यात्मक पंक्तियाँ, जिनमें दिन की पाँच और रात की पाँच मुख्य अवधियाँ हैं, और हर अवधि पाँच उप-अवधियों में बँटी है। कॉलम इंडेक्स और भिन्न हैं, घड़ी के समय नहीं — समय आपको सूर्योदय, सूर्यास्त और अवधि गुणकों से ख़ुद निकालने होंगे। nakshatras अनुरोध फ़ील्ड serializer में स्वीकार होता है, पर यह एंडपॉइंट उसका इस्तेमाल नहीं करता।
| फ़ील्ड | टाइप | ज़रूरी | टिप्पणी |
|---|---|---|---|
| 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' दो अलग क्षण हैं, और इनके उत्तर भी अलग आते हैं। |
| keys | array | ज़रूरी | कौन-सी गणनाएँ लौटानी हैं, उनके नामों की सूची। इस एंडपॉइंट की key तालिका देखें; एक भी अनजान नाम हो, तो पूरा अनुरोध अस्वीकार हो जाता है। आप जितनी चाहें keys माँगें, एक कॉल पर एक ही क्रेडिट लगता है, इसलिए कई कॉल करने के बजाय जो कुछ चाहिए, सब एक साथ माँग लें। |
| latitude | number (double) | ज़रूरी | स्थान का अक्षांश, दशमलव अंशों में। उत्तरी अक्षांश धनात्मक होता है, दक्षिणी ऋणात्मक। उदाहरण: जयपुर के लिए 26.9124, न्यूयॉर्क के लिए 40.7128। कला और विकला स्वीकार नहीं की जातीं - पहले दशमलव अंशों में बदल लें। min -90 · max 90 |
| 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 |
| nakshatras | string | वैकल्पिक | specialHTTP लेयर पर निष्क्रिय पैरामीटर - PanchaPakshaHoraView केवल date_time, geopos और pancha_pakshi_db CSV पाथ भेजता है। इंजन में इसकी इकलौती सार्थक वैल्यू शाब्दिक 'special' है (जो 28 प्रविष्टियों वाली nakshatras_special तालिका लगा देती है। |
आपको जो गणनाएँ चाहिए, बस उन्हीं के नाम keys में लिखें। कोई एक भी अनजान नाम हुआ तो पूरा अनुरोध लौटा दिया जाता है। आप कितनी भी गणनाएँ माँगें, शुल्क 1 क्रेडिट ही लगता है — इसलिए सब एक साथ माँगें।
| Key | और कौन-से फ़ील्ड चाहिए | विवरण | |
|---|---|---|---|
| get_birth_bird_from_nakshathra | — | जन्म पक्षी 1 से 5 तक के एक पूर्णांक के रूप में — 1 गिद्ध, 2 उल्लू, 3 कौआ, 4 मुर्गा, 5 मोर — जो जन्म नक्षत्र और पक्ष, दोनों से निकाला जाता है, इसलिए एक ही नक्षत्र महीने के दोनों हिस्सों में अलग पक्षी देता है। | |
| get_birth_nakshathra | — | जन्म नक्षत्र, 1 से 27 तक के एक पूर्णांक के रूप में, अश्विनी से गिनकर — इस एंडपॉइंट की बाकी खोजों को यही इनपुट चाहिए। नाम नहीं लौटाया जाता, केवल संख्या। | |
| get_matching_pancha_pakshi_data_from_db | — | माँगे गए क्षण के वार और पक्ष पर जन्म पक्षी की कच्ची गतिविधि तालिका: पचास पंक्तियाँ, हर एक चौदह संख्याओं की सूची, इस कॉलम क्रम में: वार इंडेक्स, पक्ष इंडेक्स, दिन/रात इंडेक्स, मुख्य पक्षी, मुख्य गतिविधि, उप पक्षी, उप गतिविधि, अवधि गुणक, संबंध, शक्ति गुणक, प्रभाव, रेटिंग, पडु पक्षी, भरण पक्षी। पक्षी 0-4 हैं: गिद्ध, उल्लू, कौआ, मुर्गा, मोर; गतिविधियाँ 0-4 हैं: शासन, भोजन, चलना, सोना, मरना; संबंध 0 शत्रु, 1 समान, 2 मित्र; प्रभाव 0 से 4 तक, बहुत बुरे से बहुत अच्छे तक। पंक्तियाँ पाँच-पाँच के समूहों में आती हैं — दिन के हर आधे हिस्से में पाँच मुख्य अवधियाँ, हर एक पाँच में बँटी — और अवधि गुणक बताता है कि हर उप-अवधि अपनी मूल अवधि का कितना हिस्सा है। घड़ी के समय शामिल नहीं हैं; उन्हें सूर्योदय, सूर्यास्त और गुणकों से बनाएँ। | |
| get_paksha | — | वह क्षण किस चांद्र पक्ष में है, एक पूर्णांक के रूप में: शुक्ल (बढ़ता चंद्रमा) के लिए 1, कृष्ण (घटता चंद्रमा) के लिए 2। पंच पक्षी में एक ही नक्षत्र को दोनों पक्षों में अलग-अलग पक्षी मिलता है, इसलिए इससे उत्तर बदल जाता है। |