呼叫 API 前的檢查
身份驗證
檢查身分驗證。
最低方案
檢查商店方案是否包含所需的 API 功能。
所需權限
檢查金鑰權限及所傳送欄位的條件。
需要哪種方案
| 最低方案 | 說明 |
|---|---|
| BASIC | BASIC 支援讀取訂單和客戶申請、修改它們的狀態、修改訂單支付狀態以及記錄的退款金額。 |
| STANDARD | 目錄、CMS、搜尋和庫存操作要求 STANDARD 或更高方案。 |
已經訂閱的商店也會獲得其方案包含的 API 功能。
特定操作的權限
- 參考文件列出每項操作的 required_scopes，以及敏感欄位或變更所需的 conditional_scopes。
- 讀取資源的權限不包含建立、編輯或刪除權限。
- 即使未列出資源權限，權杖核發和上下文操作仍要求身份驗證。
取得清單
GET/api/v1/products
- 身份驗證
Bearer- 最低方案
- STANDARD
- 所需權限
catalog.product:read
更新
PATCH/api/v1/products/{product_id}
- 身份驗證
Bearer- 最低方案
- STANDARD
- 所需權限
catalog.product:update
何時需要額外權限
更新
PATCH/api/v1/products/{product_id}
- 身份驗證
Bearer- 最低方案
- STANDARD
- 所需權限
catalog.product:update- 特定欄位所需的附加權限
- 提供 variant_value_ids 時:
catalog.product_variant:create,catalog.product_variant:update,catalog.product_variant:delete - 提供 variants_enabled 時:
catalog.product_variant:update
- 提供 variant_value_ids 時:
變更方案後會發生什麼
降級方案導致某項權限失效時，系統會從 API 金鑰中移除該權限，並在管理面板中取消勾選、停用對應選項。