跳到主要内容

HTTP 状态码

Shoplazza API 响应状态码和错误码

下表概述了与 Shoplazza API 交互时常见的 HTTP 状态码及其含义:

状态码

说明

200 OK

请求已被 Shoplazza 成功处理。

400 Bad Request

服务器无法理解该请求,通常是由于语法错误,或 Content-Type header 未设置为 application/json
- 请求缺少有效的鉴权凭据或凭据无效时返回。
- 请求包含无效的输入格式或请求结构(如缺少必填字段或数据类型不正确)时返回。

401 Unauthorized

请求中不存在必要的鉴权凭据,或凭据不正确。

403 Forbidden

服务器拒绝响应该请求。通常在应用未申请相应操作的访问权限时返回。

404 Not Found

请求的资源不存在。

405 Method Not Allowed

服务器识别该请求,但拒绝指定的 HTTP 方法。

406 Not Acceptable

服务器无法生成符合客户端请求的响应,例如对不处于售后状态的订单发起退款。

422 Unprocessable Entity

请求参数格式不正确。常见原因包括:
参数类型不正确:例如 published_status 参数值无效。
时间格式不正确:created_at_min、created_at_max、updated_at_min、updated_at_max、published_at_min 和 published_at_max 参数未遵循正确的时间格式。
参数值无效:例如 ids 参数不存在或格式不正确。
服务器内部错误:在极少数情况下,服务器本身可能遇到问题并返回 422 错误。

429 Too Many Requests

请求未被接受,因为应用已超出 API 速率限制。请调整请求频率。了解更多关于 Shoplazza API 速率限制的信息。

500 Internal Server Error

Shoplazza 内部发生错误。请简化或重试您的请求。如果问题持续存在,请记录错误码和时间戳,并联系合作伙伴支持寻求帮助。