调用 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 密钥中移除该权限，并在管理面板中取消勾选、禁用对应选项。