التسجيلات
نقاط النهاية الخاصة بالتسجيلات والنصوص وروابط المشاركة. جميع المسارات على https://api.recordmeeting.com وتتطلب مفتاح API. راجع المصادقة.
عرض قائمة التسجيلات
Section titled “عرض قائمة التسجيلات”GET /v1/recordingsيعيد قائمة مقسّمة إلى صفحات من التسجيلات التي يمكنك الوصول إليها.
معاملات الاستعلام
Section titled “معاملات الاستعلام”| المعامل | النوع | الافتراضي | الوصف |
|---|---|---|---|
limit | integer | 20 | عدد النتائج (من 1 إلى 100) |
offset | integer | 0 | إزاحة ترقيم الصفحات |
search | string | لا شيء | التصفية حسب نص في العنوان |
status | string | لا شيء | التصفية حسب الحالة (راجع حالات التسجيل) |
date_from | string | لا شيء | تاريخ ووقت بصيغة ISO 8601. التسجيلات المنشأة في هذا التاريخ أو بعده فقط |
date_to | string | لا شيء | تاريخ ووقت بصيغة ISO 8601. التسجيلات المنشأة في هذا التاريخ أو قبله فقط |
organization_id | string | لا شيء | عرض تسجيلات مؤسسة ما |
folder_id | string | لا شيء | عرض تسجيلات مجلد ما |
user_id | string | لا شيء | التصفية حسب المستخدم. لمسؤولي المؤسسة الذين يريدون تسجيلات عضو واحد |
الاستجابة
Section titled “الاستجابة”{ "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 عندما لا يُسمح لك بعرض تسجيلات تلك المؤسسة.
الحصول على التسجيل
Section titled “الحصول على التسجيل”GET /v1/recordings/:idيعيد التفاصيل الكاملة لتسجيل واحد.
يُعاد تسجيل المؤسسة إلى أي عضو يُسمح له بعرضه. يمكن للمالكين والمسؤولين فتح كل تسجيل في مؤسستهم. يرى المحررون والمشاهدون ما تسمح به أدوارهم ومجلداتهم. بالنسبة لتسجيل مؤسسة، تتبع is_locked وdownload_url وcapabilities خطة المؤسسة ووصول العضو إلى الميزات، وليس خطتك الشخصية.
الاستجابة
Section titled “الاستجابة”{ "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 } }}حقول يجب معرفتها
Section titled “حقول يجب معرفتها”| الحقل | الوصف |
|---|---|
notes | ملاحظات الاجتماع بصيغة Markdown. تكون null عندما لا توجد ملاحظات أو يكون التسجيل مقفلًا |
download_url | رابط تنزيل مؤقت. يكون null ما لم تكن capabilities.canDownload بالقيمة true. تنتهي صلاحيته عند download_url_expires_at |
media | روابط تشغيل مؤقتة. اطلب التسجيل مرة أخرى بعد انقضاء expires_at |
media_type | video أو 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 فارغة.
معاملات الاستعلام
Section titled “معاملات الاستعلام”| المعامل | النوع | الافتراضي | الوصف |
|---|---|---|---|
start_chunk | integer | 0 | فهرس الكتلة الأولى المطلوب إرجاعها |
limit | integer | 50 | عدد الكتل (من 1 إلى 100) |
الاستجابة
Section titled “الاستجابة”{ "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.
تحديث التسجيل
Section titled “تحديث التسجيل”PATCH /v1/recordings/:idيعيد تسمية تسجيل، أو يستبدل ملاحظات اجتماعه، أو كليهما. يلزم حقل واحد على الأقل.
جسم الطلب
Section titled “جسم الطلب”{ "title": "New title", "notes": "## Notes\nIn Markdown"}| الحقل | الوصف |
|---|---|
title | من 1 إلى 500 حرف |
notes | ملاحظات الاجتماع بصيغة Markdown، بحد أقصى 100,000 حرف. تستبدل الملاحظات الحالية |
الاستجابة
Section titled “الاستجابة”204 No Content مع جسم فارغ.
الأخطاء: 400 VALIDATION_ERROR، و404 RECORDING_NOT_FOUND.
حذف التسجيل
Section titled “حذف التسجيل”DELETE /v1/recordings/:idيحذف تسجيلًا وكل بياناته نهائيًا: النص المفرّغ، والملاحظات، وروابط المشاركة.
الاستجابة
Section titled “الاستجابة”204 No Content مع جسم فارغ.
الأخطاء: 404 RECORDING_NOT_FOUND.
إنشاء رابط مشاركة
Section titled “إنشاء رابط مشاركة”POST /v1/recordings/:id/share-linkينشئ رابط المشاركة العام لتسجيل، أو يستبدل الرابط الموجود. يتوقف الرابط السابق عن العمل.
بالنسبة لتسجيل مؤسسة، يمكن لأي عضو يستطيع عرض التسجيل إنشاء الرابط. يُنشأ الرابط باسم مالك التسجيل ويستخدم خطة المؤسسة.
جسم الطلب
Section titled “جسم الطلب”{ "permission": "view"}| القيمة | الوصف |
|---|---|
view | يمكن للأشخاص الذين لديهم الرابط مشاهدة التسجيل |
download | يمكن للأشخاص الذين لديهم الرابط تنزيله أيضًا |
الاستجابة
Section titled “الاستجابة”{ "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.
حالات التسجيل
Section titled “حالات التسجيل”| الحالة | الوصف |
|---|---|
STARTING | يجري إعداد التسجيل |
CONNECTING | جارٍ الاتصال بالاجتماع |
WAIT_APPROVAL | بانتظار الموافقة على التسجيل |
RECORDING | جارٍ التسجيل |
STALE | توقف التسجيل عن إرسال البيانات قبل اكتماله |
UPLOADING | توقف التسجيل وما زال يجري رفعه |
PROCESSING | تتم معالجة الفيديو ولا يمكن تشغيله بعد |
MIGRATING | يمكن تشغيل الفيديو أثناء نقله إلى التخزين طويل الأمد |
COMPLETED | اكتملت معالجة التسجيل بالكامل |
ERROR | فشل التسجيل |