التوثيق / مرجع الواجهة البرمجية

المصادقة

أنشئ مفاتيح API وحدّد صلاحياتها وأرسلها بأمان.

  1. افتح المطورون في لوحة التحكم واختر إنشاء مفتاح.
  2. سمِّ المفتاح واختر صلاحياته: أقل ما يحتاجه.
  3. انسخ المفتاح الآن. يُعرض مرة واحدة ويحتفظ رد ببصمته فقط.

أرسل المفتاح في ترويسة Authorization لكل طلب:

Header
Authorization: Bearer rk_live_YOUR_KEY
الصلاحيةتتيح
messages:sendإرسال الرسائل.
messages:readقراءة حالة الرسالة.
contacts:writeتسجيل موافقة جهات الاتصال.
  • حتى 10 مفاتيح نشطة لكل مساحة عمل. ألغِ أي مفتاح من صفحة المطورين في أي وقت.
  • أبقِ المفاتيح على خادمك. لا تضعها في صفحة ويب أو تطبيق جوال أو مستودع عام.
  • بدّل المفتاح بإنشاء جديد وتحويل نظامك إليه ثم إلغاء القديم.
  • استخدام الواجهة البرمجية يتطلب باقة تشمل الـ API.
الاستجابةالمعنى
401 invalid_api_keyالمفتاح مفقود أو خاطئ أو ملغى.
403 missing_scopeالمفتاح لا يملك الصلاحية المطلوبة.
المصادقة · توثيق رد