ข้ามไปยังเนื้อหา

รายการบันทึก

Endpoint สำหรับรายการบันทึก ข้อความถอดเสียง และลิงก์แชร์ ทุกพาธอยู่บน https://api.recordmeeting.com และต้องใช้ API key ดู การยืนยันตัวตน

GET /v1/recordings

ส่งคืนรายการบันทึกที่คุณเข้าถึงได้แบบแบ่งหน้า

พารามิเตอร์ประเภทค่าเริ่มต้นคำอธิบาย
limitinteger20จำนวนผลลัพธ์ (1 ถึง 100)
offsetinteger0ออฟเซตสำหรับการแบ่งหน้า
searchstringnoneกรองตามข้อความในชื่อเรื่อง
statusstringnoneกรองตามสถานะ (ดู สถานะการบันทึก)
date_fromstringnoneวันที่และเวลาแบบ ISO 8601 แสดงเฉพาะรายการบันทึกที่สร้างเมื่อเวลานั้นหรือหลังจากนั้น
date_tostringnoneวันที่และเวลาแบบ ISO 8601 แสดงเฉพาะรายการบันทึกที่สร้างเมื่อเวลานั้นหรือก่อนหน้า
organization_idstringnoneแสดงรายการบันทึกขององค์กร
folder_idstringnoneแสดงรายการบันทึกของโฟลเดอร์
user_idstringnoneกรองตามผู้ใช้ สำหรับผู้ดูแลองค์กรที่ต้องการดูรายการบันทึกของสมาชิกคนใดคนหนึ่ง
{
"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_typevideo หรือ 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 ว่าง

พารามิเตอร์ประเภทค่าเริ่มต้นคำอธิบาย
start_chunkinteger0ดัชนีของชังก์แรกที่จะส่งคืน
limitinteger50จำนวนชังก์ (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"
}
ฟิลด์คำอธิบาย
title1 ถึง 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รายการบันทึกเกิดข้อผิดพลาด