المصادقة
كل طلب إلى واجهة Record Meeting API يحتاج إلى مفتاح API. تُنشئ المفاتيح في التطبيق ضمن الإعدادات ➤ مفاتيح API.

عنوان URL الأساسي
Section titled “عنوان URL الأساسي”https://api.recordmeeting.com/v1تُكتب مسارات نقاط النهاية في هذا المرجع مع البادئة /v1، على سبيل المثال GET /v1/recordings. أضِفها إلى https://api.recordmeeting.com.
مصادقة مفتاح API
Section titled “مصادقة مفتاح API”أرسل مفتاح API الخاص بك في ترويسة Authorization. تبدأ المفاتيح بـ sk_rm_.
Authorization: Bearer sk_rm_your_keyلإنشاء مفتاح، راجع دليل المستخدم ➤ مفاتيح API. يمنح المفتاح نفس الوصول الذي يحصل عليه حسابك: تسجيلاتك الخاصة وتسجيلات المؤسسة المسموح لك بعرضها.
طلب مثال
Section titled “طلب مثال”curl "https://api.recordmeeting.com/v1/recordings" \ -H "Authorization: Bearer sk_rm_your_key"الاستجابات
Section titled “الاستجابات”الاستجابات الناجحة بصيغة JSON مع النتيجة تحت data. نقاط النهاية الخاصة بالقوائم التي تُقسّم نتائجها إلى صفحات تضيف كائن pagination. تحمل بعض الاستجابات أيضًا "success": true.
تُجيب طلبات PATCH وDELETE بالرمز 204 No Content مع جسم فارغ عند نجاحها.
استجابات الأخطاء
Section titled “استجابات الأخطاء”جميع الأخطاء بهذا التنسيق:
{ "error": { "code": "ERROR_CODE", "message": "Human readable description" }}أخطاء المصادقة
Section titled “أخطاء المصادقة”يحصل الطلب الذي لا يحتوي على ترويسة Authorization صالحة على 401.
| الرمز | حالة HTTP | المعنى |
|---|---|---|
INVALID_API_KEY | 401 | المفتاح غير موجود أو تم إبطاله |
API_KEY_EXPIRED | 401 | انتهت صلاحية المفتاح |
USER_NOT_FOUND | 401 | الحساب الذي ينتمي إليه المفتاح لم يعد موجودًا |
AUTH_ERROR | 401 | فشلت المصادقة |
رموز الأخطاء الشائعة
Section titled “رموز الأخطاء الشائعة”| الرمز | حالة HTTP | المعنى |
|---|---|---|
VALIDATION_ERROR | 400 | معاملات طلب غير صالحة أو مفقودة |
RECORDING_NOT_READY | 400 | لا يمكن مشاركة التسجيل بعد |
ORGANIZATION_SUBSCRIPTION_EXPIRED | 402 | المؤسسة التي تملك التسجيل لم يعد لديها اشتراك Enterprise نشط |
FORBIDDEN | 403 | أنت لست عضوًا في المؤسسة، أو قد لا يُسمح لك برؤية ما طلبته |
RECORDING_LOCKED | 403 | التسجيل مقفل. قم بالترقية لفتحه |
SUBSCRIPTION_REQUIRED | 403 | يتطلب هذا الإجراء خطة مدفوعة |
TRANSCRIPT_NOT_AVAILABLE | 403 | النسخ النصي معطّل للمؤسسة أو للعضو |
SHARING_DISABLED | 403 | المشاركة معطّلة للمؤسسة أو للعضو |
RECORDING_NOT_FOUND | 404 | التسجيل غير موجود أو لا يمكنك الوصول إليه |
INTERNAL_ERROR | 500 | خطأ من جانب الخادم |
نقاط النهاية
Section titled “نقاط النهاية”- التسجيلات: سرد وقراءة وتحديث وحذف التسجيلات، وقراءة النصوص المكتوبة، وإنشاء روابط المشاركة
- المؤسسات: المؤسسات والمجلدات والأعضاء
- نقاط نهاية مفاتيح API: إنشاء المفاتيح وسردها وإبطالها