API Docs
用量與錯誤說明
用量點數、回傳筆數、近 30 天自助查詢與常見錯誤碼。
用量點數
API 點數是 REST API 使用量的計算單位。實際收費依合約或正式帳單為準。
登入後可在「API 與 AI 串接中心」查看自己的近 30 天 API Key 用量。近 30 天用量不是正式帳單，只用來協助掌握使用狀況。
用量點數 = 基礎點數 × 天數係數Meta endpoint 固定 1 點 / 次，不乘天數係數。回傳筆數代表 REST API 回傳的資料筆數。Docs MCP 只讀文件，不扣 API 點數。
| Endpoint | 用量點數 |
|---|---|
/api/public/meta/categories | 固定 1 點 / 次 |
/api/public/meta/sub-categories | 固定 1 點 / 次 |
/api/public/trends/overview | 40 點 × 天數係數 |
/api/public/overview/ranking | 30 點 × 天數係數 |
/api/public/overview/growth | 40 點 × 天數係數 |
/api/public/overview/payment | 20 點 × 天數係數 |
/api/public/trends/market | 50 點 × 天數係數 |
/api/public/market/sub-ranking | 35 點 × 天數係數 |
/api/public/market/payment | 25 點 × 天數係數 |
/api/public/market/focus | 45 點 × 天數係數 |
/api/public/trends/sub-market | 60 點 × 天數係數 |
/api/public/sub-market/focus | 65 點 × 天數係數 |
/api/public/sub-market/tags | 100 點 × 天數係數 |
/api/public/sub-market/related-purchases | 固定 60 點 / 次 |
常見錯誤
| 結果 | 原始訊息 | 意思 |
|---|---|---|
| 401 | Missing API key | 未提供 `x-api-key` header。 |
| 401 | Invalid API key | API Key 不存在、格式錯誤或已被刪除。 |
| 403 | API key is inactive | API Key 已停用。 |
| 403 | API key owner is inactive | API Key 所屬帳號已停用。 |
| 402 | API 點數餘額不足 | API 點數不足，需儲值或聯絡管理員。 |
| 500 | Internal server error | 系統錯誤，請稍後重試或聯絡支援。 |