अक्सर पूछे जाने वाले सवाल

एक कॉल कितने की पड़ती है?

हर सफल कॉल पर एक क्रेडिट, चाहे उसमें कितना भी डेटा लौटे। अपवाद हैं PDF रिपोर्ट और AI चैट के एंडपॉइंट, जिनमें हर कॉल पर 25 क्रेडिट लगते हैं। एक गणना माँगें या चालीस, कीमत एक ही रहती है, क्योंकि कई एंडपॉइंट `keys` नाम की सूची लेते हैं और एक अनुरोध की सारी गणनाएँ उसी एक क्रेडिट में आ जाती हैं।

क्या विफल अनुरोध पर भी शुल्क लगता है?

नहीं। Occult API विफल अनुरोध पर कभी शुल्क नहीं लेता। गणना शुरू होने से पहले क्रेडिट अलग रख लिया जाता है, और नतीजा ठीक से न आए तो वह वापस हो जाता है। इसलिए 4xx, 5xx या टाइमआउट पर कुछ नहीं कटता, और डिबगिंग के दौरान कोई गड़बड़ इंटीग्रेशन आपका बैलेंस ख़ाली नहीं कर सकता। हर उत्तर के X-Credits-Charged हेडर में लिखा होता है कि उस पर असल में कितना खर्च हुआ।

क्या क्रेडिट की कोई समय-सीमा है?

प्लान का कोटा हर महीने रीसेट होता है। Occult API मासिक या सालाना प्लान के रूप में बिकता है: हर महीने नया कोटा मिलता है, और किसी महीने में जो कॉल इस्तेमाल नहीं हुईं, वे अगले महीने में नहीं जुड़तीं। सालाना प्लान भी ऐसे ही चलते हैं — बारह महीनों का अलग-अलग कोटा, भुगतान एक बार।

क्या कोई मुफ़्त विकल्प है?

नए खातों को मुफ़्त क्रेडिट मिलते हैं, जिन्हें असली कुंजी से लाइव API पर खर्च किया जा सकता है, किसी अलग डेटा वाले सैंडबॉक्स में नहीं। इसके अलावा occultapi.com/playground पर प्लेग्राउंड आपकी अपनी कुंजी से चालू API पर असली कॉल करता है, और वहाँ विफल कॉल पर भी कुछ नहीं लगता।

क्या सदस्यता लेनी पड़ती है?

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

मुझे 402 मिल रहा है। क्या मेरी कुंजी गलत है?

नहीं। insufficient_credits संदेश वाले 402 का मतलब है कि API कुंजी सही है, पर कोटा ख़त्म हो चुका है। नई कुंजी बनाने से कुछ नहीं होगा — प्लान अपग्रेड करें या मासिक रीसेट का इंतज़ार करें। कुंजी में ही गड़बड़ी हो, तो सिर्फ़ 401 invalid_api_key आता है।

क्या API कुंजी ब्राउज़र या मोबाइल ऐप में रख सकते हैं?

नहीं। Occult API की कुंजी एक गुप्त कुंजी है जो सिर्फ़ सर्वर पर रहनी चाहिए। फ़्रंट-एंड JavaScript या मोबाइल ऐप के अंदर रखी कुंजी कोई भी पढ़ सकता है, जो ऐप इंस्टॉल करे या डेवलपर टूल खोले, और फिर आपका बैलेंस खर्च कर सकता है। API को अपने सर्वर से कॉल कीजिए और क्लाइंट को अपना अलग एंडपॉइंट दीजिए।

मेरी कुंजी खो गई। क्या आप दोबारा भेज सकते हैं?

नहीं, और यह जानबूझकर है। Occult API कुंजियों को सिर्फ़ SHA-256 हैश के रूप में रखता है, इसलिए न कोई एडमिन और न ही डेटाबेस की कोई कॉपी असली कुंजी वापस निकाल सकती है। नई कुंजी बनाइए और पुरानी रद्द कर दीजिए। यह तुरंत लागू होता है और क्रेडिट बैलेंस पर कोई असर नहीं पड़ता।

अगर कुंजी लीक हो जाए तो?

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

गणनाएँ किस आधार पर होती हैं?

Occult API की गणनाएँ NASA JPL के एफ़ेमेरिस डेटा पर आधारित हैं। पूरा डेटा, 735 स्थिर तारों के साथ, सन् 500 से 2999 तक। कुछ भी किसी पहले से बनी तालिका से नहीं पढ़ा जाता। हर उत्तर अनुरोध में दिए ठीक उसी पल और उसी जगह के लिए गणना करके बनता है।

आपका नतीजा किसी दूसरे स्रोत से मेल नहीं खाता। ऐसा क्यों?

आम तौर पर वजह अयनांश होता है। भारतीय परंपराओं में इस पर सच में मतभेद है, और एक अंश का अंतर भी किसी ग्रह को एक नक्षत्र से दूसरे में पहुँचा सकता है। Occult API 48 अयनांश देता है और हर एक को अंश, कला और विकला तक ठीक किया जा सकता है। इसलिए पहले यह देखिए कि दोनों स्रोत एक ही अयनांश इस्तेमाल कर रहे हैं या नहीं।

यह कितना तेज़ है?

सर्वर पर मीडियन उत्तर समय 62 ms है। यह किसी चुने हुए उदाहरण पर नहीं, हर प्रकाशित उदाहरण पर नापा गया है। कुछ एंडपॉइंट भारी गणनाएँ करते हैं, जैसे पूरे वर्षफल की जाँच या एक साल की राशि दशा, और उनमें कुछ सेकंड लगते हैं। API संदर्भ में यह साफ़ लिखा है, मीडियन के पीछे छिपाया नहीं गया।

क्या OpenAPI स्पेक या SDK है?

Occult API occultapi.com/openapi.json पर OpenAPI 3.1 दस्तावेज़ प्रकाशित करता है। यह उसी कैटलॉग से बनता है जिससे डॉक्स बनते हैं, और हर ऑपरेशन के साथ एक उदाहरण है: 299 में से 255 लाइव सर्वर से लिए गए, बाकी अनुरोध के स्कीमा से बनाए गए। openapi-generator या ऐसे किसी भी टूल से इसकी मदद से किसी भी भाषा में टाइप वाला क्लाइंट बनाया जा सकता है। इसके अलावा एक Postman कलेक्शन और AI असिस्टेंट के लिए एक MCP सर्वर भी है।

क्या कोई AI असिस्टेंट इसे कॉल कर सकता है?

हाँ। Occult API का MCP सर्वर पाँच टूल के ज़रिए हर एंडपॉइंट उपलब्ध कराता है। इससे एंडपॉइंट खोजने और अनुरोध के स्कीमा पढ़ने में कोई क्रेडिट नहीं लगता, सिर्फ़ असली गणना में लगता है। इसलिए असिस्टेंट कुछ भी खर्च करने से पहले पूरा API देख सकता है। कोडिंग एजेंट के लिए निर्देश occultapi.com/AGENTS.md पर हैं।

क्या मैं API से मिला डेटा बेच सकता हूँ?

हाँ। Occult API आपको अपने प्रोडक्ट में इस डेटा के व्यावसायिक इस्तेमाल का रॉयल्टी-मुक्त लाइसेंस देता है। इसमें उत्तरों को अपने डेटाबेस में रखना, रिपोर्ट बनाकर बेचना और क्लाइंट के काम में इस्तेमाल करना शामिल है। हमारा नाम देना ज़रूरी नहीं। बस API की पहुँच को ही API के रूप में आगे बेचने की अनुमति नहीं है।

क्या आप मेरा भेजा जन्म विवरण अपने पास रखते हैं?

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

क्या आप DPA देते हैं?

हाँ। Occult API ने GDPR के अनुच्छेद 28 के तहत एक डेटा प्रोसेसिंग समझौता (DPA) प्रकाशित किया है। साथ में सब-प्रोसेसर की मौजूदा सूची भी है, जिसमें हर उस तीसरे पक्ष का नाम है जो ग्राहक डेटा तक पहुँच सकता है।

अगर आपका सवाल यहाँ नहीं है, तो mridul.kabra23@gmail.com पर लिखिए। हमने क्या नापा है और क्या नहीं, यह गणना पद्धति में है; हम क्या रखते हैं और क्या अभी नहीं बनाया, यह पारदर्शिता में। सभी त्रुटि कोड ऑथेंटिकेशन वाले पेज पर हैं, और वहीं यह भी बताया है कि 402 ऑथेंटिकेशन की त्रुटि क्यों नहीं है।