रिकॉर्डिंग

रिकॉर्डिंग की सूची बनाएं

GET /api/v1/recordings

प्रमाणीकृत उपयोगकर्ता के लिए सुलभ रिकॉर्डिंग की एक पृष्ठित सूची लौटाता है।

क्वेरी पैरामीटर

पैरामीटर	प्रकार	डिफ़ॉल्ट	विवरण
limit	संख्या	20	परिणामों की संख्या (1-100)
offset	संख्या	0	पृष्ठांकन ऑफसेट
search	स्ट्रिंग	-	शीर्षक के अनुसार फ़िल्टर करें (आंशिक मिलान)
status	स्ट्रिंग	-	स्थिति के अनुसार फ़िल्टर करें (रिकॉर्डिंग स्थितियाँ देखें)
date_from	स्ट्रिंग	-	ISO 8601 दिनांक - केवल उस तारीख को या उसके बाद बनाई गई रिकॉर्डिंग लौटाएं
date_to	स्ट्रिंग	-	ISO 8601 दिनांक - केवल उस तारीख को या उससे पहले बनाई गई रिकॉर्डिंग लौटाएं
organization_id	स्ट्रिंग	-	किसी संगठन तक सीमित करें
folder_id	स्ट्रिंग	-	किसी फ़ोल्डर तक सीमित करें (organization_id आवश्यक है)

प्रतिक्रिया

{
  "data": [
    {
      "id": "uuid",
      "status": "COMPLETED",
      "title": "साप्ताहिक सिंक",
      "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

एकल रिकॉर्डिंग के लिए पूर्ण विवरण लौटाता है।

संगठन रिकॉर्डिंग किसी भी संगठन सदस्य के लिए उपलब्ध होती हैं जिसे उन्हें देखने की अनुमति है। मालिक और व्यवस्थापक अपने संगठन में हर रिकॉर्डिंग खोल सकते हैं; संपादक और दर्शक उन रिकॉर्डिंग को देखते हैं जिनकी उनके भूमिका और फ़ोल्डर तक पहुंच की अनुमति होती है। एक संगठन रिकॉर्डिंग के लिए, is_locked, download_url और capabilities संगठन की योजना और सदस्य के फीचर फ़्लैग को दर्शाते हैं, न कि कॉलर की व्यक्तिगत योजना को।

जब संगठन का एंटरप्राइज़ सदस्यता अब सक्रिय नहीं होती है, तो 402 ORGANIZATION_SUBSCRIPTION_EXPIRED लौटाता है।

प्रतिक्रिया

{
  "data": {
    "id": "uuid",
    "status": "COMPLETED",
    "title": "साप्ताहिक सिंक",
    "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": ["वक्ता 1", "वक्ता 2"],
      "segmentsCount": 184,
      "duration": 1740.5
    },
    "summary": {
      "status": "completed",
      "content": "## मुख्य विषय\n...",
      "topics": [
        {
          "title": "परियोजना समयरेखा",
          "keyPoints": [
            { "point": "लॉन्च की तारीख की पुष्टि", "details": ["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

एक रिकॉर्डिंग के लिए पृष्ठित प्रतिलेख खंड लौटाता है।

संगठन रिकॉर्डिंग रिकॉर्डिंग प्राप्त करें के समान पहुंच नियमों का पालन करती हैं। जब रिकॉर्डिंग लॉक होती है और जब संगठन या सदस्य के लिए प्रतिलेखन अक्षम होता है, तो 403 TRANSCRIPT_NOT_AVAILABLE लौटाता है, तो 403 RECORDING_LOCKED लौटाता है। एक रिकॉर्डिंग जिसे अभी तक प्रतिलेखित नहीं किया गया है, फिर भी "status": "not_started" और एक खाली segments सरणी के साथ 200 लौटाता है।

क्वेरी पैरामीटर

पैरामीटर	प्रकार	डिफ़ॉल्ट	विवरण
start_chunk	संख्या	0	शुरू करने के लिए चंक इंडेक्स
limit	संख्या	50	चंक्स की संख्या (1-100)

प्रतिक्रिया

{
  "data": {
    "status": "completed",
    "language": "en",
    "speakers": ["वक्ता 1", "एलिस"],
    "duration": 1740.5,
    "segments": [
      {
        "id": 1,
        "start": 0.5,
        "end": 3.2,
        "text": "सुप्रभात सभी को।",
        "speaker": "एलिस",
        "confidence": 0.97
      }
    ],
    "pagination": {
      "total_chunks": 184,
      "has_more": true
    }
  }
}

---

रिकॉर्डिंग अपडेट करें

PATCH /api/v1/recordings/:id

एक रिकॉर्डिंग का शीर्षक या नोट्स अपडेट करें। कम से कम एक फ़ील्ड आवश्यक है।

अनुरोध बॉडी

{
  "title": "नया शीर्षक (1-500 वर्ण)",
  "notes": "वैकल्पिक नोट्स (अधिकतम 100,000 वर्ण)"
}

प्रतिक्रिया

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

---

रिकॉर्डिंग हटाएं

DELETE /api/v1/recordings/:id

एक रिकॉर्डिंग और सभी संबंधित डेटा (प्रतिलेख, सारांश, शेयर) को स्थायी रूप से हटाता है।

प्रतिक्रिया

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

खतरा

डिलीशन स्थायी है और इसे पूर्ववत नहीं किया जा सकता है।

---

शेयर लिंक बनाएं

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

रिकॉर्डिंग के लिए एक सार्वजनिक शेयर लिंक जनरेट करता है।

एक संगठन रिकॉर्डिंग के लिए, कोई भी सदस्य जो रिकॉर्डिंग देख सकता है, वह लिंक बना सकता है। लिंक रिकॉर्डिंग मालिक की ओर से बनाया जाता है और संगठन की योजना का उपयोग करता है, इसलिए download लिंक संगठन रिकॉर्डिंग के लिए भी काम करते हैं, भले ही कॉलर की व्यक्तिगत योजना मुफ्त हो। जब रिकॉर्डिंग लॉक होती है और जब संगठन या सदस्य के लिए साझाकरण अक्षम होता है, तो 403 SHARING_DISABLED लौटाता है, तो 403 RECORDING_LOCKED लौटाता है।

अनुरोध बॉडी

{
  "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 स्ट्रीम HLS/DASH पैकेजिंग - अभी तक चलाने योग्य नहीं है
MIGRATING	वीडियो पूरी तरह से चलाने योग्य; HLS को दीर्घकालिक स्टोरेज में माइग्रेट किया जा रहा है
COMPLETED	रिकॉर्डिंग पूरी तरह से संसाधित और संग्रहीत
ERROR	रिकॉर्डिंग विफल

API उपभोक्ताओं को प्लेबैक, डाउनलोड और शेयर ऑपरेशन के लिए MIGRATING को COMPLETED के समान ही मानना चाहिए - अंतर आंतरिक है।