อัปเดตล่าสุด
บัญชี
แพ็กเกจ ขีดจำกัด และการใช้เครดิตของเวิร์กสเปซที่เป็นเจ้าของคีย์
ทุกการดำเนินการยืนยันตัวตนด้วย API key (Authorization: Bearer <key>) และข้อผิดพลาดใช้โครงสร้างร่วมที่อธิบายไว้ใน ข้อผิดพลาด. สร้างจากเอกสาร OpenAPI ของ API
ดึงแพ็กเกจและขีดจำกัด
/v1/entitlementsแพ็กเกจ โมดูล ขีดจำกัดอัตรา และกระเป๋าเครดิตของเวิร์กสเปซในรอบบิลหนึ่ง: limits.watchlistMax, limits.requestsPerMinute (คำขอด้วยคีย์ API ต่อนาทีรวมทุกคีย์ของเวิร์กสเปซ), credits.hardCap (เครดิตของแพ็กเกจบวกการเติมเครดิตในรอบนี้), credits.resetAt (เวลาที่เครดิตของรอบรีเซ็ต), exports (การส่งออกในแอปวันนี้ perDay เป็น 0 ในแพ็กเกจ free และเป็น null คือไม่จำกัดในแพ็กเกจที่ชำระเงิน) และ money (เพชร 1 เม็ดเป็น USD รวมโดยประมาณ ส่วนแบ่งของครีเอเตอร์ และอัตราแลกเปลี่ยน VND รายเดือน: เป็นค่าประมาณเพื่อแสดงผล ไม่ใช่เงินที่ TikTok จ่ายจริง)
พารามิเตอร์ query
| Name | Type | Description |
|---|---|---|
periodOptional | string | วันเริ่มต้นรอบการเรียกเก็บเงิน YYYY-MM-01 ค่าเริ่มต้นคือรอบปัจจุบัน |
คำขอ
curl "https://api.next.toktokdata.live/v1/entitlements" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"ผลลัพธ์
{ "data": { "workspaceId": "4388fdb0-ef68-5d01-ac84-b683b2b355e8", "planCode": "agency", "tier": "agency", "modules": [ "live", "lookup" ], "limits": { "requestsPerWindow": 150, "rateWindowMs": 1000, "apiRequestsPerSecond": 150, "requestsPerDay": 1200000, "requestsPerMinute": 9000, "maxApiKeys": 0, "wsConcurrencyCap": 200, "maxRoomMinutesPerMonth": 800000, "historyWindowDays": 365, "maxSeats": 10, "seatsUsed": 2, "exportFormats": [ "csv", "xlsx" ], "watchlistMax": 25 }, "credits": { "period": "2026-11-01", "monthlyAllotment": 36000000, "hardCap": 36000000, "spent": 0, "remaining": 0, "resetAt": "2026-12-01T00:00:00.000Z" }, "money": { "diamondUsdGross": 0.01, "creatorShare": 0.5, "vndPerUsd": 25500, "rateLabel": "estimate · 2026-11" }, "exports": { "perDay": null, "usedToday": 1 } }, "provenance": { "observedAt": "2026-11-01T11:19:24.411834Z", "freshness": "near_realtime", "source": "plan_entitlement", "sourceKind": "derived", "coverageStatus": "observed", "methodologyVersion": "entitlements-v1", "window": { "from": "2026-11-01", "to": "2026-12-01", "label": "2026-11" } }}ข้อผิดพลาด
400พารามิเตอร์หรือ body ไม่ถูกต้องcodeจะระบุปัญหา401ไม่มี API key หรือไม่รู้จัก API key403คีย์ไม่มีสโคปที่ต้องการ หรือแพ็กเกจไม่รวมฟีเจอร์นี้429เกินอัตราคำขอ (ต่อวินาที ต่อนาที หรือต่อวัน) โปรดทำตามRetry-After
ดึงการใช้เครดิต
/v1/usageเครดิตที่ใช้ต่อการดำเนินการในรอบการเรียกเก็บเงินหนึ่ง
พารามิเตอร์ query
| Name | Type | Description |
|---|---|---|
periodOptional | string | วันเริ่มต้นรอบการเรียกเก็บเงิน YYYY-MM-01 ค่าเริ่มต้นคือรอบปัจจุบัน |
limitOptional | integer | จำนวนแถวสูงสุด |
คำขอ
curl "https://api.next.toktokdata.live/v1/usage" \ -H "Authorization: Bearer $ROOMSCOPE_API_KEY"ผลลัพธ์
{ "period": "2026-11-01", "balance": { "remaining": 0, "spent": 0 }, "items": [], "provenance": { "observedAt": "2026-11-01T10:00:00.000Z", "freshness": "near_realtime", "source": "credit_ledger", "sourceKind": "derived", "coverageStatus": "observed", "methodologyVersion": "usage-v1", "window": { "from": "2026-11-01", "to": "2026-12-01", "label": "2026-11" } }}ข้อผิดพลาด
400พารามิเตอร์หรือ body ไม่ถูกต้องcodeจะระบุปัญหา401ไม่มี API key หรือไม่รู้จัก API key403คีย์ไม่มีสโคปที่ต้องการ หรือแพ็กเกจไม่รวมฟีเจอร์นี้429เกินอัตราคำขอ (ต่อวินาที ต่อนาที หรือต่อวัน) โปรดทำตามRetry-After