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

التسجيلات

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

GET /v1/recordings

يعيد قائمة مقسّمة إلى صفحات من التسجيلات التي يمكنك الوصول إليها.

المعاملالنوعالافتراضيالوصف
limitinteger20عدد النتائج (من 1 إلى 100)
offsetinteger0إزاحة ترقيم الصفحات
searchstringلا شيءالتصفية حسب نص في العنوان
statusstringلا شيءالتصفية حسب الحالة (راجع حالات التسجيل)
date_fromstringلا شيءتاريخ ووقت بصيغة ISO 8601. التسجيلات المنشأة في هذا التاريخ أو بعده فقط
date_tostringلا شيءتاريخ ووقت بصيغة ISO 8601. التسجيلات المنشأة في هذا التاريخ أو قبله فقط
organization_idstringلا شيءعرض تسجيلات مؤسسة ما
folder_idstringلا شيءعرض تسجيلات مجلد ما
user_idstringلا شيءالتصفية حسب المستخدم. لمسؤولي المؤسسة الذين يريدون تسجيلات عضو واحد
{
"data": [
{
"id": "uuid",
"title": "Weekly sync",
"status": "COMPLETED",
"created_at": "2026-09-19T15:00:00.000Z",
"duration_seconds": 1740,
"thumbnail_url": "https://...",
"folder_id": null,
"organization_id": null,
"transcription_status": "completed",
"notes_status": "completed",
"is_shared": true,
"processing_progress": null
}
],
"pagination": {
"total": 42,
"limit": 20,
"offset": 0,
"has_more": true
}
}

يمكن أن تكون title وduration_seconds وthumbnail_url وfolder_id وorganization_id وtranscription_status وnotes_status وprocessing_progress بالقيمة null. في التسجيل المقفل، تكون transcription_status وnotes_status بالقيمة null.

عند استخدام organization_id، لا يحصل المحررون والمشاهدون إلا على التسجيلات المسموح لهم برؤيتها. عندئذٍ يكون total حدًا أعلى، وقد تحتوي الصفحة على عناصر أقل من limit.

الأخطاء: 400 VALIDATION_ERROR، و403 FORBIDDEN عندما لا يُسمح لك بعرض تسجيلات تلك المؤسسة.


GET /v1/recordings/:id

يعيد التفاصيل الكاملة لتسجيل واحد.

يُعاد تسجيل المؤسسة إلى أي عضو يُسمح له بعرضه. يمكن للمالكين والمسؤولين فتح كل تسجيل في مؤسستهم. يرى المحررون والمشاهدون ما تسمح به أدوارهم ومجلداتهم. بالنسبة لتسجيل مؤسسة، تتبع is_locked وdownload_url وcapabilities خطة المؤسسة ووصول العضو إلى الميزات، وليس خطتك الشخصية.

{
"data": {
"id": "uuid",
"title": "Weekly sync",
"status": "COMPLETED",
"created_at": "2026-09-19T15:00:00.000Z",
"updated_at": "2026-09-19T15:30:00.000Z",
"started_at": "2026-09-19T15:01:00.000Z",
"ended_at": "2026-09-19T15:30:00.000Z",
"duration_seconds": 1740,
"thumbnail_url": "https://...",
"download_url": "https://...",
"download_url_expires_at": "2026-09-19T21:30:00.000Z",
"folder_id": null,
"organization_id": null,
"processing_progress": null,
"transcription": {
"status": "completed",
"language": "en",
"speakers": ["Alice", "Bob"],
"segments_count": 184
},
"notes": "## Key topics\n...",
"notes_status": "completed",
"notes_truncated": false,
"sharing": {
"is_shared": true,
"share_url": "https://recordmeeting.com/app/shared/abc123"
},
"participants": [
{
"id": "participant_id",
"displayName": "Alice",
"email": "alice@example.com",
"source": "calendar",
"isOrganizer": true,
"mappedSpeaker": "Alice",
"avatarUrl": null
}
],
"media_type": "video",
"is_locked": false,
"open_url": "https://recordmeeting.com/app/recording/uuid",
"media": {
"hls_url": "https://...",
"direct_url": "https://...",
"expires_at": "2026-09-19T21:30:00.000Z"
},
"capabilities": {
"canDownload": true,
"canShare": true,
"canViewTranscription": true,
"canStartTranscription": true,
"canRegenerateTranscription": false,
"canRenameSpeaker": true,
"canReplaceText": true,
"canViewSummary": true,
"canGenerateSummary": true,
"canAskQuestions": true,
"canGenerateArtifacts": true
}
}
}
الحقلالوصف
notesملاحظات الاجتماع بصيغة Markdown. تكون null عندما لا توجد ملاحظات أو يكون التسجيل مقفلًا
download_urlرابط تنزيل مؤقت. يكون null ما لم تكن capabilities.canDownload بالقيمة true. تنتهي صلاحيته عند download_url_expires_at
mediaروابط تشغيل مؤقتة. اطلب التسجيل مرة أخرى بعد انقضاء expires_at
media_typevideo أو audio
is_lockedتكون true عندما يكون التسجيل مقفلًا. عندئذٍ تكون transcription وnotes بالقيمة null
open_urlصفحة التسجيل في تطبيق الويب
sharing.share_urlرابط مشاركة التسجيل، أو null عندما لا يكون لديه رابط

الأخطاء: 404 RECORDING_NOT_FOUND، و402 ORGANIZATION_SUBSCRIPTION_EXPIRED عندما لا يعود اشتراك المؤسسة في Enterprise نشطًا.


الحصول على النص المفرّغ

Section titled “الحصول على النص المفرّغ”
GET /v1/recordings/:id/transcript

يعيد النص المفرّغ للتسجيل كمقاطع، في صفحات من الكتل.

تتبع تسجيلات المؤسسة قواعد الوصول نفسها المذكورة في الحصول على التسجيل. التسجيل الذي ليس لديه نص مفرّغ بعد يعيد 200 مع "status": "not_started" ومصفوفة segments فارغة.

المعاملالنوعالافتراضيالوصف
start_chunkinteger0فهرس الكتلة الأولى المطلوب إرجاعها
limitinteger50عدد الكتل (من 1 إلى 100)
{
"data": {
"status": "completed",
"language": "en",
"speakers": ["Alice", "Bob"],
"duration": 1740.5,
"segments": [
{
"id": 1,
"start": 0.5,
"end": 3.2,
"text": "Good morning everyone.",
"speaker": "Alice",
"confidence": 0.97
}
],
"pagination": {
"total_chunks": 4,
"has_more": true
}
}
}

تكون start وend بالثواني. يمكن أن تكون speaker وconfidence بالقيمة null. ما دامت has_more بالقيمة true، اطلب الصفحة التالية باستخدام start_chunk أعلى.

الأخطاء: 403 RECORDING_LOCKED للتسجيل المقفل، و403 TRANSCRIPT_NOT_AVAILABLE عندما يكون التفريغ النصي معطّلًا للمؤسسة أو للعضو، و403 SUBSCRIPTION_REQUIRED عندما يتطلب النص المفرّغ الكامل خطة مدفوعة، و404 RECORDING_NOT_FOUND، و402 ORGANIZATION_SUBSCRIPTION_EXPIRED.


PATCH /v1/recordings/:id

يعيد تسمية تسجيل، أو يستبدل ملاحظات اجتماعه، أو كليهما. يلزم حقل واحد على الأقل.

{
"title": "New title",
"notes": "## Notes\nIn Markdown"
}
الحقلالوصف
titleمن 1 إلى 500 حرف
notesملاحظات الاجتماع بصيغة Markdown، بحد أقصى 100,000 حرف. تستبدل الملاحظات الحالية

204 No Content مع جسم فارغ.

الأخطاء: 400 VALIDATION_ERROR، و404 RECORDING_NOT_FOUND.


DELETE /v1/recordings/:id

يحذف تسجيلًا وكل بياناته نهائيًا: النص المفرّغ، والملاحظات، وروابط المشاركة.

204 No Content مع جسم فارغ.

الأخطاء: 404 RECORDING_NOT_FOUND.


POST /v1/recordings/:id/share-link

ينشئ رابط المشاركة العام لتسجيل، أو يستبدل الرابط الموجود. يتوقف الرابط السابق عن العمل.

بالنسبة لتسجيل مؤسسة، يمكن لأي عضو يستطيع عرض التسجيل إنشاء الرابط. يُنشأ الرابط باسم مالك التسجيل ويستخدم خطة المؤسسة.

{
"permission": "view"
}
القيمةالوصف
viewيمكن للأشخاص الذين لديهم الرابط مشاهدة التسجيل
downloadيمكن للأشخاص الذين لديهم الرابط تنزيله أيضًا
{
"data": {
"share_url": "https://recordmeeting.com/app/shared/abc123",
"share_token": "abc123",
"permission": "view"
}
}

الأخطاء: 400 VALIDATION_ERROR، و400 RECORDING_NOT_READY عندما لا يمكن مشاركة التسجيل بعد، و403 RECORDING_LOCKED، و403 SHARING_DISABLED عندما تكون المشاركة معطّلة للمؤسسة أو للعضو، و403 SUBSCRIPTION_REQUIRED عندما يتطلب الإذن خطة مدفوعة، و404 RECORDING_NOT_FOUND، و402 ORGANIZATION_SUBSCRIPTION_EXPIRED.


الحالةالوصف
STARTINGيجري إعداد التسجيل
CONNECTINGجارٍ الاتصال بالاجتماع
WAIT_APPROVALبانتظار الموافقة على التسجيل
RECORDINGجارٍ التسجيل
STALEتوقف التسجيل عن إرسال البيانات قبل اكتماله
UPLOADINGتوقف التسجيل وما زال يجري رفعه
PROCESSINGتتم معالجة الفيديو ولا يمكن تشغيله بعد
MIGRATINGيمكن تشغيل الفيديو أثناء نقله إلى التخزين طويل الأمد
COMPLETEDاكتملت معالجة التسجيل بالكامل
ERRORفشل التسجيل