التسجيلات

قائمة التسجيلات

GET /api/v1/recordings

تعرض قائمة مُرقَّمة من التسجيلات التي يمكن للمستخدم الموثق الوصول إليها.

معلمات الاستعلام

المعلمة	النوع	الافتراضي	الوصف
limit	number	20	عدد النتائج (1–100)
offset	number	0	إزاحة ترقيم الصفحات
search	string	-	تصفية حسب العنوان (تطابق جزئي)
status	string	-	تصفية حسب الحالة (انظر حالات التسجيل)
date_from	string	-	تاريخ ISO 8601 - إرجاع التسجيلات التي أنشئت في هذا التاريخ أو بعده فقط
date_to	string	-	تاريخ ISO 8601 - إرجاع التسجيلات التي أنشئت في هذا التاريخ أو قبله فقط
organization_id	string	-	تحديد النطاق لمنظمة
folder_id	string	-	تحديد النطاق لمجلد (يتطلب organization_id)

الاستجابة

{
  "data": [
    {
      "id": "uuid",
      "status": "COMPLETED",
      "title": "Weekly sync",
      "createdAt": "2025-09-19T15:00:00.000Z",
      "thumbnailUrl": "https://...",
      "progress": 1.0,
      "capabilities": {
        "canDownload": true,
        "canShare": true,
        "canViewTranscription": true,
        "canGenerateSummary": true,
        "canAskQuestions": true
      }
    }
  ],
  "pagination": {
    "total": 42,
    "limit": 20,
    "offset": 0,
    "has_more": true
  }
}

---

الحصول على التسجيل

GET /api/v1/recordings/:id

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

الاستجابة

{
  "data": {
    "id": "uuid",
    "status": "COMPLETED",
    "title": "Weekly sync",
    "createdAt": "2025-09-19T15:00:00.000Z",
    "updatedAt": "2025-09-19T15:30:00.000Z",
    "startedAt": "2025-09-19T15:01:00.000Z",
    "endedAt": "2025-09-19T15:30:00.000Z",
    "videoUrl": "https://...",
    "hlsUrl": "https://...",
    "downloadUrl": "https://...",
    "downloadUrlExpiresAt": "2025-09-19T21:00:00.000Z",
    "thumbnailUrl": "https://...",
    "organizationId": "org_uuid or null",
    "transcription": {
      "status": "completed",
      "language": "en",
      "speakers": ["Speaker 1", "Speaker 2"],
      "segmentsCount": 184,
      "duration": 1740.5
    },
    "summary": {
      "status": "completed",
      "content": "## Key topics\n...",
      "topics": [
        {
          "title": "Project timeline",
          "keyPoints": [
            { "point": "Launch date confirmed", "details": ["Set for Q1"] }
          ]
        }
      ]
    },
    "isLocked": false,
    "capabilities": {
      "canDownload": true,
      "canShare": true,
      "canViewTranscription": true,
      "canStartTranscription": true,
      "canRegenerateTranscription": false,
      "canRenameSpeaker": true,
      "canViewSummary": true,
      "canGenerateSummary": true,
      "canAskQuestions": true
    }
  }
}

---

الحصول على مقاطع المحضر

GET /api/v1/recordings/:id/transcript

يعرض مقاطع المحضر المرقَّمة لتسجيل.

معلمات الاستعلام

المعلمة	النوع	الافتراضي	الوصف
start_chunk	number	0	فهرس الجزء للبدء منه
limit	number	50	عدد الأجزاء (1–100)

الاستجابة

{
  "data": {
    "status": "completed",
    "language": "en",
    "speakers": ["Speaker 1", "Alice"],
    "duration": 1740.5,
    "segments": [
      {
        "id": 1,
        "start": 0.5,
        "end": 3.2,
        "text": "Good morning everyone.",
        "speaker": "Alice",
        "confidence": 0.97
      }
    ],
    "pagination": {
      "total_chunks": 184,
      "has_more": true
    }
  }
}

---

تحديث التسجيل

PATCH /api/v1/recordings/:id

تحديث عنوان أو ملاحظات تسجيل. مطلوب حقل واحد على الأقل.

نص الطلب

{
  "title": "New title (1–500 characters)",
  "notes": "Optional notes (max 100,000 characters)"
}

الاستجابة

{
  "data": { "success": true }
}

---

حذف التسجيل

DELETE /api/v1/recordings/:id

يحذف التسجيل وجميع البيانات المرتبطة به (النص، الملخص، المشاركات) بشكل دائم.

الاستجابة

{
  "data": { "success": true }
}

تحذير

الحذف نهائي ولا يمكن التراجع عنه.

---

إنشاء رابط مشاركة

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

ينشئ رابط مشاركة عام للتسجيل.

نص الطلب

{
  "permission": "view"
}

القيمة	الوصف
view	يمكن للمستلمين مشاهدة الفيديو والوصول إلى النص/الملخص
download	يمكن للمستلمين أيضًا تنزيل ملف الفيديو

الاستجابة

{
  "data": {
    "share_url": "https://recordmeeting.com/app/shared/abc123",
    "share_token": "abc123",
    "permission": "view"
  }
}

---

حالات التسجيل

الحالة	الوصف
STARTING	تم استلام طلب التسجيل، الإعداد قيد التقدم
CONNECTING	جاري الاتصال بجلسة Google Meet
WAIT_APPROVAL	انتظار الموافقة داخل المكالمة للتسجيل
RECORDING	جاري التسجيل بنشاط
UPLOADING	جاري التحميل من جانب العميل (تفريغ الأجزاء إلى التخزين)
PROCESSING	Cloudflare Stream يقوم بتغليف HLS/DASH - غير قابل للتشغيل بعد
MIGRATING	الفيديو قابل للتشغيل بالكامل؛ يتم ترحيل HLS إلى التخزين طويل الأمد
COMPLETED	تم معالجة التسجيل وتخزينه بالكامل
ERROR	فشل التسجيل

يجب على مستهلكي واجهة برمجة التطبيقات (API) التعامل مع MIGRATING بشكل مطابق تمامًا لـ COMPLETED لعمليات التشغيل والتنزيل والمشاركة - التمييز داخلي.