تخطَّ إلى المحتوى

نقاط نهاية مفاتيح API

نقاط نهاية لإدارة مفاتيح API الخاصة بك. جميع المسارات على https://api.recordmeeting.com وتتطلب مفتاح API. راجع المصادقة.

يجب إنشاء مفتاحك الأول في التطبيق، من خلال الإعدادات ➤ مفاتيح API. راجع دليل المستخدم ➤ مفاتيح API.

POST /v1/api-keys

ينشئ مفتاح API جديدًا لحسابك.

{
"name": "My integration"
}
الحقلمطلوبالوصف
nameنعماسم العرض للمفتاح (من 1 إلى 100 حرف)

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.


GET /v1/api-keys

يعيد مفاتيح API الخاصة بحسابك. لا تُعاد قيمة المفتاح الكاملة أبدًا بعد إنشائه.

{
"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 للمفتاح الذي لم يُستخدم قط.


DELETE /v1/api-keys/:id

يلغي مفتاح API نهائيًا. من ذلك الحين، تفشل الطلبات التي تستخدم هذا المفتاح بالرمز 401 INVALID_API_KEY. لا يمكن التراجع عن هذا الإجراء.

204 No Content مع نص فارغ.

الرمزحالة HTTPالمعنى
API_KEY_NOT_FOUND404المفتاح غير موجود أو ينتمي إلى حساب آخر
ALREADY_REVOKED400تم إلغاء المفتاح بالفعل