Postman कलेक्शन का इस्तेमाल

कलेक्शन का हर अनुरोध ऑथेंटिकेट होता है, इसलिए डेटा पाने के लिए पहले कुंजी चाहिए। कुंजी बनाना मुफ़्त है; क्रेडिट तभी ख़र्च होते हैं जब कॉल सफल हो।

1. 1occultapi.com/signup पर खाता बनाएँ और अपना ईमेल सत्यापित करें।
2. 2डैशबोर्ड में API keys खोलें और Create key दबाएँ।
3. 3कुंजी तुरंत कॉपी कर लें। वह सिर्फ़ एक बार दिखती है और हैश के रूप में रखी जाती है, इसलिए कोई भी — हम भी नहीं — उसे दोबारा नहीं दिखा सकता। खो जाए तो वापस नहीं मिलती, नई बनानी पड़ती है।

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

अनुरोध उसी तरह समूहों में हैं जैसे संदर्भ में: पंचांग, मुहूर्त, दशाएँ, कुंडलियाँ, कैलेंडर वगैरह। हर अनुरोध के साथ वही विवरण है जो डॉक्स में दिखता है, और वही बॉडी जिससे उसका उदाहरण उत्तर लिया गया था।

कलेक्शन पढ़ने के लिए खाता नहीं चाहिए, पर अनुरोध भेजने के लिए आपकी अपनी कॉपी चाहिए। फ़ोर्क करने से वह बन जाती है।

1. 1Postman में साइन इन करें, या मुफ़्त खाता बनाएँ।
2. 2कलेक्शन के ऊपर Fork Collection दबाएँ, या उसके नाम के पास फ़ोर्क वाला आइकन।
3. 3फ़ोर्क को कोई लेबल दें — अपना नाम भी चलेगा — और वह वर्कस्पेस चुनें जिसमें इसे रखना है।
4. 4Watch original collection पर टिक लगा रहने दें। इसी से आप बाद में दोबारा फ़ोर्क किए बिना नए एंडपॉइंट ले पाएँगे।
5. 5Fork Collection दबाएँ। आपकी कॉपी खुल जाएगी, और उसमें आप जो भी बदलें, हमारे कलेक्शन पर कोई असर नहीं पड़ेगा।

Postman खाता नहीं बनाना चाहते? JSON डाउनलोड करें और Postman डेस्कटॉप ऐप में Import से खोलें। इसमें अपडेट वाला लिंक नहीं रहता, इसलिए API में नए एंडपॉइंट आने पर दोबारा इम्पोर्ट करना होगा।

कलेक्शन का Variables टैब खोलें। उसमें दो वेरिएबल हैं: baseUrl, जो पहले से https://api.occultapi.com पर सेट है, और apiKey, जो ख़ाली है। apiKey के मान में अपनी कुंजी डालें और सेव करें।

ऑथेंटिकेशन के लिए बस इतना ही करना है। कलेक्शन का हर अनुरोध कुंजी यहीं से लेता है और उसे X-API-Key हेडर में भेजता है, इसलिए 299 अनुरोधों में अलग-अलग नहीं, एक ही बार डालनी पड़ती है। अगर अभी कुंजी नहीं है, तो अपने डैशबोर्ड से लें।

हर अनुरोध JSON बॉडी के साथ POST है, और URL में {{baseUrl}} लगा है, ताकि होस्ट कभी टाइप न करना पड़े। हर अनुरोध का विवरण वही है जो संदर्भ में उसके पेज पर है।

1. 1साइडबार में कोई फ़ोल्डर खोलें — शुरुआत के लिए Astrology / Dasha अच्छा है — और किसी अनुरोध पर क्लिक करें।
2. 2देख लें कि Authorization टैब में लिखा हो कि वह कलेक्शन से ले रहा है। यह वही apiKey है जो आपने अभी डाली; हेडर ख़ुद नहीं जोड़ना है।
3. 3Send दबाएँ। बॉडी में पहले से सही मान भरे हैं, इसलिए पहली कॉल बिना कुछ बदले चल जाती है।

Body टैब खोलें और मान बदलें। कुंडली के लिए ज़्यादातर जानकारी चार फ़ील्ड में होती है। इनमें गलती हो तो आम तौर पर त्रुटि नहीं आती, बल्कि ऐसा उत्तर आता है जो थोड़ा-सा गलत होता है।

1. 1date_time — ISO 8601 में, और ऑफ़सेट हमेशा लिखें (+05:30) या आख़िर में Z। बिना समय क्षेत्र वाला मान Asia/Kolkata माना जाता है, जिससे भारत के बाहर किसी की भी कुंडली चुपचाप खिसक जाती है।
2. 2latitude और longitude — दशमलव अंशों में, अंश-कला में नहीं। चिह्न पर ध्यान दें: माइनस छूट जाए तो न्यूयॉर्क चीन में पहुँच जाता है।
3. 3timezone_as_float — घंटों में ऑफ़सेट, दशमलव में। भारत के लिए 5.5, न्यूयॉर्क के लिए -5।
4. 4JSON बिखर जाए तो Beautify दबाएँ, फिर दोबारा Send करें।

उत्तर नीचे वाले हिस्से में खुलता है। बॉडी में डेटा है; हेडर बताते हैं कि कॉल से आपके बैलेंस पर क्या असर पड़ा।

1. 1Body — JSON। सब कुछ data के अंदर है, और उसके साथ message और is_error।
2. 2Headers — X-Credits-Cost बताता है कि वह एंडपॉइंट कितना लेता है, X-Credits-Charged कि असल में कितना कटा, और X-Credits-Remaining कि उसके बाद कितना बैलेंस बचा।
3. 3किसी भी विफलता पर Charged 0 दिखाता है — चाहे बॉडी गलत हो, तारीख़ गलत हो या गलती हमारी हो। बेझिझक प्रयोग करें; पैसा सिर्फ़ उन्हीं कॉल का लगता है जो डेटा लौटाती हैं।
4. 4किसी उत्तर को अनुरोध के साथ सँभालने के लिए Save as example दबाएँ, ताकि आपकी टीम बिना क्रेडिट ख़र्च किए उसका ढाँचा देख सके।

जब अनुरोध ठीक वैसा चलने लगे जैसा आप चाहते हैं, तो Postman उसे आपकी भाषा में लिख देगा। दाईं पट्टी में </> Code आइकन खोलें और cURL, Python, Node, PHP, Go या कोई और भाषा चुनें।

स्निपेट में {{baseUrl}} की जगह असली होस्ट आ जाता है और X-API-Key हेडर भी रहता है, इसलिए वह जैसा है वैसा चल जाता है। कमिट करने से पहले कुंजी की जगह एनवायरनमेंट वेरिएबल लगा दें — स्निपेट में असली कुंजी है।

कलेक्शन या फ़ोल्डर के ऊपर वाला Run बटन उसके सारे अनुरोध क्रम से भेजता है। यह जाँचने में काम आता है कि कुंजी पूरी श्रेणी पर चलती है या नहीं, या कुछ बदलने के बाद झटपट जाँच के लिए।

ध्यान रहे, हर सफल कॉल पर एक क्रेडिट लगता है, इसलिए सभी 299 चलाने पर 299 क्रेडिट लगेंगे — बल्कि इससे ज़्यादा, क्योंकि चैट एंडपॉइंट और दोनों PDF रिपोर्ट पर 25-25 लगते हैं। जब तक सच में पूरा कलेक्शन न चलाना हो, एक फ़ोल्डर ही चलाएँ।

कलेक्शन उसी सूची से बनता है जिससे डॉक्स बनते हैं, इसलिए API में नए एंडपॉइंट आते ही कलेक्शन में भी आ जाते हैं।

1. 1मूल कलेक्शन बदलने पर Postman आपके फ़ोर्क पर pull changes का विकल्प दिखाता है।
2. 2इसे लेने से नए अनुरोध आ जाते हैं, और आपकी बदली हुई बॉडी या सेट किए वेरिएबल नहीं छेड़े जाते।
3. 3बदलावों की सूची में लिखा है कि क्या और कब जुड़ा, ताकि आप तय कर सकें कि बदलाव लेना है या नहीं।