مرجع
المصادقة
كل طلب يحمل رمز bearer في ترويسة Authorization. النطاقات تحدّد ما يمكن للرمز فعله.
رموز bearer
أرسل مفتاحك بصيغة “Authorization: Bearer …”. بدون مفتاح صالح ستحصل على 401.
Scopes
يحصل الرمز فقط على النطاقات التي اخترتها. أي طلب خارجها يُرجع 403.
الاختبار والتشغيل الفعلي
مفاتيح الاختبار لا تمسّ البيانات الحقيقية أبدًا. انتقل إلى الوضع الفعلي عندما تكون جاهزًا.
الحدود، وما يحدث عندما تتجاوز أحدها
هناك حدّان أقصيان لكل مفتاح: واحد في الدقيقة وآخر في اليوم. إذا تجاوزت أيًّا منهما فستحصل على 429 مع ترويسة Retry-After تخبرك بمدة الانتظار — وتوضّح لك الرسالة أيّ حدّ بلغته. أما المفتاح الذي يظل عند حدّه يومًا بعد يوم فيراجعه إنسان وقد يُغلَق مؤقتًا؛ عندها تحصل على 403 مع السبب بداخله، لتعرف أن الأمر منّا لا من مفتاحك.