Meta · whoami
ใช้ตรวจว่า API key ที่ส่งมาผูกกับธุรกิจไหนและมี scope อะไรบ้าง — เหมาะกับการ debug ระหว่างพัฒนาหรือตอนเข้าเวร (on-call) รูปแบบ response ขึ้นกับ ระดับ ของ key (business หรือ account) ดูได้จากฟิลด์ level
GET /meta/whoami
ตรวจข้อมูลของ API key
curl https://phone.mcloud.co.th/api/v1/meta/whoami \
-H "Authorization: Bearer crk_..."
Business key
Business key ผูกกับธุรกิจเดียว และตอบ scope ที่ key นั้นมีอยู่
{
"level": "business",
"business": {
"id": "0192...",
"name": "Acme Co",
"slug": "acme"
},
"scopes": [
"view_recording_all",
"manage_recording_review"
]
}
Account key
Account key ไม่ผูกกับธุรกิจใด — มีสิทธิ์เต็ม (manage_all) ในทุกธุรกิจที่เจ้าของ key เป็นสมาชิก เรียก whoami โดยไม่ต้องส่ง header X-Business-Id เพื่อดู id ของธุรกิจที่ส่งให้ endpoint อื่นได้ ซึ่งก็คือรายการในฟิลด์ businesses
{
"level": "account",
"userId": "0192...",
"scopes": ["manage_all"],
"businesses": [
{ "id": "0192...", "name": "Acme Co", "slug": "acme" },
{ "id": "0193...", "name": "Globex", "slug": "globex" }
]
}
businesses แสดงเฉพาะธุรกิจ ส่วนพื้นที่ Meet ส่วนตัวของคุณไม่ใช่ธุรกิจ จึงไม่อยู่ในรายการนี้ ถ้าจะอ่านการประชุมของตัวเอง ให้ส่ง X-Business-Id: personal (ดูหน้า Meetings)
สำหรับ account key ทุก endpoint อื่นต้องส่ง header
X-Business-Id: <business id>เพื่อเลือกว่าจะทำงานกับธุรกิจไหน ยกเว้นการประชุมของตัวเอง ซึ่งใช้X-Business-Id: personalดูเพิ่มที่ เริ่มต้นใช้งาน → API key ระดับบัญชี
GET /storage
พื้นที่เก็บไฟล์ของธุรกิจ — ไฟล์เสียงสายใช้ไปเท่าไร โควตาที่ใช้อยู่ และจะเกิดอะไรต่อ ต้องมีสิทธิ์ view_billing หรือ manage_billing
curl https://phone.mcloud.co.th/api/v1/storage -H "Authorization: Bearer crk_..."
{
"enabled": true,
"state": "over",
"usedBytes": 6656360448,
"trashBytes": 268435456,
"files": 14210,
"quotaBytes": 5368709120,
"usedPct": 124,
"warnPct": 80,
"graceDays": 7,
"overSince": "2026-11-13T02:00:00.000Z",
"purgeAfter": "2026-11-20T02:00:00.000Z",
"toFreeBytes": 1825361101,
"purgePreview": { "files": 4050, "bytes": 1825361101, "trashFiles": 310, "from": "2026-06-02T03:10:00.000Z", "to": "2026-07-18T09:40:00.000Z" },
"lastPurge": null,
"package": null,
"computedAt": "2026-11-15T08:00:00.000Z"
}
state:ok·warn(ใช้ถึงwarnPctของโควตา) ·over·unlimited(ตอนนั้นquotaBytesเป็นnull)- เกินโควตา = มีเวลา
graceDaysวัน (purgeAfter) ถ้ายังเกินอยู่ ไฟล์เสียงเก่าสุด จะถูกลบ (ถังขยะก่อน) จนกลับมาไม่เกินโควตา ลบเฉพาะไฟล์ รายการสาย บทถอด สรุป และคะแนนยังอยู่ และสายนั้นจะมีaudioRemovedAt(ดูหน้า Recordings) - สายใหม่ยังเข้าและวิเคราะห์ตามปกติระหว่างที่พื้นที่เกิน
enabled: false= ระบบยังไม่เปิดใช้โควตา ไม่มีการจำกัดหรือลบ และคำตอบมีแค่{ "enabled": false }- ไฟล์ที่เก็บในที่เก็บของธุรกิจเอง (S3 ของคุณ) ไม่นับ ส่วนที่เก็บที่ระบบดูแลให้ธุรกิจนับเหมือนที่เก็บกลาง