इसे छोड़कर कंटेंट पर जाएं

रिकॉर्डिंग्स

रिकॉर्डिंग्स, ट्रांसक्रिप्ट्स और शेयर लिंक के लिए एंडपॉइंट्स। सभी पाथ https://api.recordmeeting.com पर हैं और उनके लिए API कुंजी आवश्यक है। प्रमाणीकरण देखें।

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

Section titled “रिकॉर्डिंग्स की सूची बनाएं”
GET /v1/recordings

आप जिन रिकॉर्डिंग्स तक पहुँच सकते हैं, उनकी पेज-आधारित सूची लौटाता है।

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

Section titled “क्वेरी पैरामीटर”
पैरामीटरप्रकारडिफ़ॉल्टविवरण
limitपूर्णांक20परिणामों की संख्या (1 से 100)
offsetपूर्णांक0पेजिनेशन ऑफ़सेट
searchस्ट्रिंगकोई नहींशीर्षक में टेक्स्ट के आधार पर फ़िल्टर करें
statusस्ट्रिंगकोई नहींस्थिति के आधार पर फ़िल्टर करें (रिकॉर्डिंग स्थितियाँ देखें)
date_fromस्ट्रिंगकोई नहींISO 8601 दिनांक-समय। केवल उसी या उसके बाद बनाई गई रिकॉर्डिंग्स
date_toस्ट्रिंगकोई नहींISO 8601 दिनांक-समय। केवल उसी या उससे पहले बनाई गई रिकॉर्डिंग्स
organization_idस्ट्रिंगकोई नहींकिसी संगठन की रिकॉर्डिंग्स की सूची बनाएं
folder_idस्ट्रिंगकोई नहींकिसी फ़ोल्डर की रिकॉर्डिंग्स की सूची बनाएं
user_idस्ट्रिंगकोई नहींउपयोगकर्ता के आधार पर फ़िल्टर करें। उन संगठन एडमिन के लिए जो किसी एक सदस्य की रिकॉर्डिंग्स चाहते हैं
{
"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 आपकी व्यक्तिगत योजना के नहीं, बल्कि संगठन की योजना और सदस्य की सुविधा पहुँच के अनुसार होते हैं।

{
"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 “जानने योग्य फ़ील्ड”
फ़ील्डविवरण
notesMarkdown में मीटिंग नोट्स। जब कोई नोट्स न हों या रिकॉर्डिंग लॉक हो तो null
download_urlएक अस्थायी डाउनलोड लिंक। जब तक capabilities.canDownload का मान true न हो, यह null होता है। यह 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 ऐरे होता है।

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

Section titled “क्वेरी पैरामीटर”
पैरामीटरप्रकारडिफ़ॉल्टविवरण
start_chunkपूर्णांक0लौटाने के लिए पहले चंक का इंडेक्स
limitपूर्णांक50चंक्स की संख्या (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।


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

Section titled “रिकॉर्डिंग अपडेट करें”
PATCH /v1/recordings/:id

किसी रिकॉर्डिंग का नाम बदलता है, उसके मीटिंग नोट्स बदलता है, या दोनों करता है। कम से कम एक फ़ील्ड आवश्यक है।

{
"title": "New title",
"notes": "## Notes\nIn Markdown"
}
फ़ील्डविवरण
title1 से 500 अक्षर
notesMarkdown में मीटिंग नोट्स, अधिकतम 100,000 अक्षर। मौजूदा नोट्स को बदल देता है

खाली बॉडी के साथ 204 No Content।

त्रुटियाँ: 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND।


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

Section titled “रिकॉर्डिंग हटाएं”
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।


रिकॉर्डिंग स्थितियाँ

Section titled “रिकॉर्डिंग स्थितियाँ”
स्थितिविवरण
STARTINGरिकॉर्डिंग सेट अप की जा रही है
CONNECTINGमीटिंग से कनेक्ट किया जा रहा है
WAIT_APPROVALरिकॉर्ड करने की अनुमति की प्रतीक्षा है
RECORDINGरिकॉर्डिंग चल रही है
STALEरिकॉर्डिंग पूरी होने से पहले डेटा भेजना बंद कर चुकी है
UPLOADINGरिकॉर्डिंग रुक गई है और अभी भी अपलोड हो रही है
PROCESSINGवीडियो प्रोसेस हो रहा है और अभी चलाया नहीं जा सकता
MIGRATINGवीडियो को दीर्घकालिक स्टोरेज में ले जाते समय भी उसे चलाया जा सकता है
COMPLETEDरिकॉर्डिंग पूरी तरह प्रोसेस हो चुकी है
ERRORरिकॉर्डिंग विफल रही