รายการบันทึก
Endpoint สำหรับรายการบันทึก ข้อความถอดเสียง และลิงก์แชร์ ทุกพาธอยู่บน https://api.recordmeeting.com และต้องใช้ API key ดู การยืนยันตัวตน
ดูรายการบันทึก
หัวข้อที่มีชื่อว่า “ดูรายการบันทึก”GET /v1/recordingsส่งคืนรายการบันทึกที่คุณเข้าถึงได้แบบแบ่งหน้า
พารามิเตอร์ของ query
หัวข้อที่มีชื่อว่า “พารามิเตอร์ของ query”| พารามิเตอร์ | ประเภท | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|---|
limit | integer | 20 | จำนวนผลลัพธ์ (1 ถึง 100) |
offset | integer | 0 | ออฟเซตสำหรับการแบ่งหน้า |
search | string | none | กรองตามข้อความในชื่อเรื่อง |
status | string | none | กรองตามสถานะ (ดู สถานะการบันทึก) |
date_from | string | none | วันที่และเวลาแบบ ISO 8601 แสดงเฉพาะรายการบันทึกที่สร้างเมื่อเวลานั้นหรือหลังจากนั้น |
date_to | string | none | วันที่และเวลาแบบ ISO 8601 แสดงเฉพาะรายการบันทึกที่สร้างเมื่อเวลานั้นหรือก่อนหน้า |
organization_id | string | none | แสดงรายการบันทึกขององค์กร |
folder_id | string | none | แสดงรายการบันทึกของโฟลเดอร์ |
user_id | string | none | กรองตามผู้ใช้ สำหรับผู้ดูแลองค์กรที่ต้องการดูรายการบันทึกของสมาชิกคนใดคนหนึ่ง |
การตอบกลับ
หัวข้อที่มีชื่อว่า “การตอบกลับ”{ "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 ผู้ใช้บทบาท Editor และ Viewer จะได้รับเฉพาะรายการบันทึกที่ได้รับอนุญาตให้ดูเท่านั้น ในกรณีนี้ total จะเป็นเพียงขอบเขตบน และหนึ่งหน้าอาจมีรายการน้อยกว่า limit ได้
ข้อผิดพลาด: 400 VALIDATION_ERROR, 403 FORBIDDEN เมื่อคุณไม่ได้รับอนุญาตให้แสดงรายการบันทึกขององค์กรนั้น
ดึงข้อมูลรายการบันทึก
หัวข้อที่มีชื่อว่า “ดึงข้อมูลรายการบันทึก”GET /v1/recordings/:idส่งคืนรายละเอียดทั้งหมดของรายการบันทึกหนึ่งรายการ
รายการบันทึกขององค์กรจะถูกส่งคืนให้สมาชิกทุกคนที่ได้รับอนุญาตให้ดูได้ เจ้าของและ Admin เปิดดูรายการบันทึกทุกรายการในองค์กรของตนได้ ส่วน Editor และ Viewer จะเห็นตามที่บทบาทและโฟลเดอร์อนุญาต สำหรับรายการบันทึกขององค์กร ค่า 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 } }}ฟิลด์ที่ควรรู้
หัวข้อที่มีชื่อว่า “ฟิลด์ที่ควรรู้”| ฟิลด์ | คำอธิบาย |
|---|---|
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 ขององค์กรไม่ فعالแล้ว
ดึงข้อความถอดเสียง
หัวข้อที่มีชื่อว่า “ดึงข้อความถอดเสียง”GET /v1/recordings/:id/transcriptส่งคืนข้อความถอดเสียงของรายการบันทึกในรูปแบบเซกเมนต์ แบ่งหน้าเป็นชังก์
รายการบันทึกขององค์กรใช้กฎการเข้าถึงเดียวกับ ดึงข้อมูลรายการบันทึก รายการบันทึกที่ยังไม่มีข้อความถอดเสียงจะยังคงส่งคืน 200 โดยมี "status": "not_started" และอาร์เรย์ segments ว่าง
พารามิเตอร์ของ query
หัวข้อที่มีชื่อว่า “พารามิเตอร์ของ query”| พารามิเตอร์ | ประเภท | ค่าเริ่มต้น | คำอธิบาย |
|---|---|---|---|
start_chunk | integer | 0 | ดัชนีของชังก์แรกที่จะส่งคืน |
limit | integer | 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
แก้ไขรายการบันทึก
หัวข้อที่มีชื่อว่า “แก้ไขรายการบันทึก”PATCH /v1/recordings/:idเปลี่ยนชื่อรายการบันทึก แทนที่บันทึกการประชุม หรือทำทั้งสองอย่าง ต้องระบุอย่างน้อยหนึ่งฟิลด์
เนื้อหาคำขอ
หัวข้อที่มีชื่อว่า “เนื้อหาคำขอ”{ "title": "New title", "notes": "## Notes\nIn Markdown"}| ฟิลด์ | คำอธิบาย |
|---|---|
title | 1 ถึง 500 ตัวอักษร |
notes | บันทึกการประชุมในรูปแบบ Markdown ยาวสูงสุด 100,000 ตัวอักษร จะแทนที่บันทึกเดิม |
การตอบกลับ
หัวข้อที่มีชื่อว่า “การตอบกลับ”204 No Content พร้อมเนื้อหาว่าง
ข้อผิดพลาด: 400 VALIDATION_ERROR, 404 RECORDING_NOT_FOUND
ลบรายการบันทึก
หัวข้อที่มีชื่อว่า “ลบรายการบันทึก”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
สถานะการบันทึก
หัวข้อที่มีชื่อว่า “สถานะการบันทึก”| สถานะ | คำอธิบาย |
|---|---|
STARTING | กำลังตั้งค่ารายการบันทึก |
CONNECTING | กำลังเชื่อมต่อกับการประชุม |
WAIT_APPROVAL | กำลังรอการอนุมัติให้บันทึก |
RECORDING | กำลังบันทึกอยู่ |
STALE | การบันทึกหยุดส่งข้อมูลก่อนที่จะเสร็จสิ้น |
UPLOADING | การบันทึกหยุดแล้วและยังคงอัปโหลดอยู่ |
PROCESSING | วิดีโอกำลังถูกประมวลผลและยังเล่นไม่ได้ |
MIGRATING | วิดีโอเล่นได้ในระหว่างที่ถูกย้ายไปยังที่จัดเก็บระยะยาว |
COMPLETED | รายการบันทึกประมวลผลเสร็จสมบูรณ์ |
ERROR | รายการบันทึกเกิดข้อผิดพลาด |