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