نقاط نهاية مفاتيح API
نقاط نهاية لإدارة مفاتيح API الخاصة بك. جميع المسارات على https://api.recordmeeting.com وتتطلب مفتاح API. راجع المصادقة.
يجب إنشاء مفتاحك الأول في التطبيق، من خلال الإعدادات ➤ مفاتيح API. راجع دليل المستخدم ➤ مفاتيح API.
إنشاء مفتاح API
Section titled “إنشاء مفتاح API”POST /v1/api-keysينشئ مفتاح API جديدًا لحسابك.
نص الطلب
Section titled “نص الطلب”{ "name": "My integration"}| الحقل | مطلوب | الوصف |
|---|---|---|
name | نعم | اسم العرض للمفتاح (من 1 إلى 100 حرف) |
الاستجابة
Section titled “الاستجابة”201 Created
{ "data": { "id": "key_uuid", "name": "My integration", "prefix": "sk_rm_a1b2c3", "key": "sk_rm_a1b2c3d4e5f6...", "created_at": "2026-09-19T15:00:00.000Z" }}الأخطاء: 400 VALIDATION_ERROR.
عرض قائمة مفاتيح API
Section titled “عرض قائمة مفاتيح API”GET /v1/api-keysيعيد مفاتيح API الخاصة بحسابك. لا تُعاد قيمة المفتاح الكاملة أبدًا بعد إنشائه.
الاستجابة
Section titled “الاستجابة”{ "data": [ { "id": "key_uuid", "name": "My integration", "prefix": "sk_rm_a1b2c3", "created_at": "2026-09-19T15:00:00.000Z", "last_used_at": "2026-09-20T10:30:00.000Z", "is_revoked": false } ]}يكون last_used_at مساويًا لـ null للمفتاح الذي لم يُستخدم قط.
إلغاء مفتاح API
Section titled “إلغاء مفتاح API”DELETE /v1/api-keys/:idيلغي مفتاح API نهائيًا. من ذلك الحين، تفشل الطلبات التي تستخدم هذا المفتاح بالرمز 401 INVALID_API_KEY. لا يمكن التراجع عن هذا الإجراء.
الاستجابة
Section titled “الاستجابة”204 No Content مع نص فارغ.
رموز الأخطاء
Section titled “رموز الأخطاء”| الرمز | حالة HTTP | المعنى |
|---|---|---|
API_KEY_NOT_FOUND | 404 | المفتاح غير موجود أو ينتمي إلى حساب آخر |
ALREADY_REVOKED | 400 | تم إلغاء المفتاح بالفعل |