रिकॉर्डिंग्स
रिकॉर्डिंग्स, ट्रांसक्रिप्ट्स और शेयर लिंक के लिए एंडपॉइंट्स। सभी पाथ 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 | स्ट्रिंग | कोई नहीं | उपयोगकर्ता के आधार पर फ़िल्टर करें। उन संगठन एडमिन के लिए जो किसी एक सदस्य की रिकॉर्डिंग्स चाहते हैं |
प्रतिक्रिया
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 | एक अस्थायी डाउनलोड लिंक। जब तक capabilities.canDownload का मान true न हो, यह null होता है। यह 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 | पूर्णांक | 0 | लौटाने के लिए पहले चंक का इंडेक्स |
limit | पूर्णांक | 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 | रिकॉर्डिंग विफल रही |