المصادقة

مفاتيح API

صادِق على طلبات API الخاصة بالعملاء باستخدام Authorization: Bearer re_…. تنتمي المفاتيح إلى مساحة عمل واحدة ويجب ألا تُضمَّن أبدًا في المتصفح أو تطبيقات الجوال أو سطح المكتب أو القوالب أو محتوى البريد.

Authorization: Bearer re_your_key_here

جلسات المتصفح

تستخدم لوحة التحكم ملف تعريف ارتباط للجلسة مقتصرًا على HTTP وقابلًا للإلغاء. وتتطلب تغييرات الفوترة وإنشاء مفاتيح API أو إلغاؤها هذه الجلسة ولا تتاح لمفاتيح Bearer. ويمكن لمفتاح Bearer قراءة حالة الحساب والاستخدام والفوترة نفسها عبر GET /account، وتحليلات لوحة التحكم عبر GET /analytics، والبيانات الوصفية للمفاتيح (الاسم والبادئة وآخر استخدام) عبر GET /keys.

التدوير

1. أنشئ مفتاحًا بديلًا من جلسة لوحة تحكم موثَّقة.
2. انشر المفتاح البديل في كل خدمة تجري الاستدعاءات.
3. تأكد من أن الحركة تستخدم البادئة الجديدة.
4. ألغِ المفتاح القديم.

إخفاقات المصادقة

يعيد أي اعتماد مفقود أو منتهي الصلاحية أو ملغى أو غير معروف الخطأ 401 باستخدام غلاف الأخطاء القياسي. لا تعِد محاولة إخفاقات المصادقة تلقائيًا.

{
  "error": {
    "message": "Unauthorized — provide a valid API key or session",
    "status": 401
  }
}