Version: v202601

OpenAPI

Shoplazza 2026-01 OpenAPI 允许应用读写 Shoplazza 店铺数据。本页介绍 2026-01 版本的请求模型、身份验证、速率限制和错误响应。

身份验证每个请求都需要携带有效的应用访问令牌。速率限制按平台限制设计调用频率和重试策略。状态和错误代码处理该版本中的 400、403 和 500 响应。

身份验证

所有 OpenAPI 请求都需要身份验证。请在 access-token 请求头中传入应用访问令牌。

字段	值
Security scheme type	apiKey
Header parameter name	access-token

公开应用通过应用授权流程获取 access token。私有或内部集成应使用店铺和应用对应的令牌。

速率限制

Shoplazza API 会进行限流，以保护平台稳定性。如果请求过于频繁，请降低调用频率、将任务放入队列、缓存重复读取结果，并在短暂延迟后重试。

请根据响应状态和响应体判断是否重试。参数校验错误需要先修正请求，不要直接重复重试。

状态和错误代码

当前 API 版本的常见错误响应归为以下三类状态码。

状态码	含义	处理建议
400 Bad Request	店铺、token 或请求参数校验问题。	检查店铺上下文、access token，以及参数名称、类型、必填字段和请求体格式。
403 Forbidden	应用权限不足，无法执行该操作。	检查应用 scopes，并确认商家已授权所需权限。
500 Internal Server Error	底层业务逻辑无法完成操作。	检查库存不足等业务约束；仅在操作可安全重复时重试。