Meta · whoami

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 ของคุณ) ไม่นับ ส่วนที่เก็บที่ระบบดูแลให้ธุรกิจนับเหมือนที่เก็บกลาง