تصدیق

ہر درخواست Authorization ہیڈر میں ایک bearer ٹوکن لے کر جاتی ہے۔ اسکوپس طے کرتے ہیں کہ ایک ٹوکن کیا کر سکتا ہے۔

1. Bearer ٹوکن

   اپنی کلید کو “Authorization: Bearer …” کے طور پر بھیجیں۔ درست کلید کے بغیر آپ کو 401 ملے گا۔

2. Scopes

   ٹوکن کو صرف وہی اسکوپس ملتے ہیں جو آپ نے چنے۔ ان سے باہر کی درخواست 403 لوٹاتی ہے۔

3. ٹیسٹ اور لائیو

   ٹیسٹ کلیدیں کبھی حقیقی ڈیٹا کو نہیں چھوتیں۔ تیار ہوں تو لائیو پر سوئچ کریں۔

4. حدود، اور جب آپ کسی حد سے تجاوز کریں تو کیا ہوتا ہے

   ہر کی کے لیے دو حدیں ہیں: ایک فی منٹ اور ایک فی دن۔ ان میں سے کوئی بھی پار کرتے ہی آپ کو Retry-After ہیڈر کے ساتھ 429 ملتا ہے جو بتاتا ہے کہ کتنی دیر انتظار کرنا ہے — پیغام آپ کو بتاتا ہے کہ آپ نے کون سی حد چھوئی۔ جو کی دن بہ دن اپنی حد پر ٹکی رہتی ہے، اسے ایک انسان دیکھتا ہے اور اسے عارضی طور پر بند کیا جا سکتا ہے؛ تب آپ کو وجہ کے ساتھ 403 ملتا ہے، تاکہ آپ جان لیں کہ مسئلہ ہماری طرف سے ہے، آپ کی کی میں نہیں۔