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

endpoints ของคีย์ API

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

คีย์แรกของคุณต้องสร้างในแอป ภายใต้ Settings ➤ API keys ดู คู่มือผู้ใช้ ➤ คีย์ API

POST /v1/api-keys

สร้างคีย์ API ใหม่สำหรับบัญชีของคุณ

{
"name": "My integration"
}
ฟิลด์จำเป็นคำอธิบาย
nameใช่ชื่อที่แสดงสำหรับคีย์ (1 ถึง 100 อักขระ)

201 Created

{
"data": {
"id": "key_uuid",
"name": "My integration",
"prefix": "sk_rm_a1b2c3",
"key": "sk_rm_a1b2c3d4e5f6...",
"created_at": "2026-09-19T15:00:00.000Z"
}
}

ข้อผิดพลาด: 400 VALIDATION_ERROR


GET /v1/api-keys

ส่งคืนคีย์ API ของบัญชีของคุณ ค่าคีย์แบบเต็มจะไม่ถูกส่งกลับอีกหลังจากการสร้าง

{
"data": [
{
"id": "key_uuid",
"name": "My integration",
"prefix": "sk_rm_a1b2c3",
"created_at": "2026-09-19T15:00:00.000Z",
"last_used_at": "2026-09-20T10:30:00.000Z",
"is_revoked": false
}
]
}

last_used_at จะเป็น null สำหรับคีย์ที่ไม่เคยถูกใช้งาน


DELETE /v1/api-keys/:id

เพิกถอนคีย์ API อย่างถาวร คำขอที่ใช้คีย์นี้จะล้มเหลวด้วย 401 INVALID_API_KEY ตั้งแต่บัดนี้เป็นต้นไป การดำเนินการนี้ไม่สามารถย้อนกลับได้

204 No Content พร้อมเนื้อหาว่างเปล่า

รหัสสถานะ HTTPความหมาย
API_KEY_NOT_FOUND404ไม่มีคีย์นี้อยู่ หรือคีย์นี้เป็นของบัญชีอื่น
ALREADY_REVOKED400คีย์นี้ถูกเพิกถอนไปแล้ว