ऑथेंटिकेशन
API को जाने वाली हर रिक्वेस्ट में API कुंजी होती है। रिक्वेस्ट को कभी भी ब्राउज़र सेशन से नहीं जोड़ा जाता।
API कुंजी बनाना
अपने अकाउंट में API कुंजियाँ के अंदर कुंजियाँ बनाएँ, अधिकतम 5। साइन इन रहते हुए आप उस पेज से कुंजी कभी भी कॉपी कर सकते हैं: हम उसे एन्क्रिप्ट करके रखते हैं, और केवल आपको दिखाते हैं। उसे पासवर्ड की तरह गुप्त रखें, और अगर कुंजी किसी ने देखी हो सकती है, तो उसे रद्द करके नई कुंजी बनाएँ।
API कुंजी भेजना
इसे Authorization हेडर में Bearer के बाद कुंजी लिखकर भेजें। X-API-Key भी काम करता है।
curl "https://api.talismanleads.io/v1/account" \
-H "Authorization: Bearer tl_live_your_key_here"API कुंजी क्या कर सकती है
नई API कुंजी सब कुछ कर सकती है: आपका बैलेंस, चेकर, आपके ऑर्डर और उनके नतीजे देख सकती है, और POST /uploads, POST /estimates और POST /orders का इस्तेमाल कर सकती है, जो आपकी लिस्ट सेव करते हैं या आपका बैलेंस खर्च करते हैं। 8 नवंबर 2026 से पहले बनी कुंजी रीड-ओनली हो सकती है: वह सब कुछ देख सकती है, लेकिन ये तीनों कॉल उसे missing_scope के साथ अस्वीकार कर देते हैं।
एक्सपायरी और IP पते
नई API कुंजी कभी एक्सपायर नहीं होती और किसी भी पते से काम करती है। 8 नवंबर 2026 से पहले बनी कुंजी की एक्सपायरी तारीख हो सकती है, जिसके बाद वह expired_key के साथ अस्वीकार हो जाती है, या वह आपके सर्वर के IP पतों तक सीमित हो सकती है, जिससे किसी और जगह से आई रिक्वेस्ट ip_not_allowed के साथ अस्वीकार हो जाती है। इनमें से कुछ भी बदलने के लिए, नई कुंजी बनाएँ और पुरानी कुंजी रद्द करें।
API कुंजी को सुरक्षित रखना
- API कुंजी को पासवर्ड की तरह रखें: जिसके पास यह है, वह आपका बैलेंस खर्च कर सकता है।
- इसे केवल अपने सर्वर पर इस्तेमाल करें। API वेब पेज से कॉल की अनुमति नहीं देता।
- इसे अपने कोड और वर्ज़न कंट्रोल से बाहर रखें।
- अगर कुंजी किसी ने देखी हो सकती है, तो उसे तुरंत अपने अकाउंट में रद्द करें। वह उसी समय काम करना बंद कर देती है। पहले से दिए गए ऑर्डर चलते रहते हैं।
- इसे केवल API को भेजें। अपलोड और डाउनलोड लिंक में उनकी अपनी अनुमति होती है, इसलिए उन पर अपनी API कुंजी न भेजें।
जब API कुंजी अस्वीकार हो
गलत, रद्द की गई या तारीख निकल चुकी API कुंजी पर 401 मिलता है। ब्लॉक की गई API कुंजी या अकाउंट पर 403 मिलता है। देखें एरर।