تصدیق
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 ملتا ہے۔ دیکھیں خرابیاں۔