HTTP 状态码​

HTTP 状态码是 SHOPLINE API 的重要组成部分。对于每次 API 调用，响应中会包含一个 HTTP 状态码，用于指示请求结果。

状态码说明​

类别​

HTTP 状态码由三位数字组成，其中第一位数字定义了响应的类别。

SHOPLINE API 使用以下状态码类别：

• 2xx：成功。服务器已收到、理解并接受请求。
• 3xx：重定向。客户端需采取进一步操作以完成请求，如跳转至新地址。
• 4xx：客户端错误。请求无法处理，通常由参数格式错误、鉴权失败或资源不存在等客户端原因引起。
• 5xx：服务端错误。请求本身没有问题，但 SHOPLINE 服务端发生异常。通常为临时性故障，可稍后重试或联系技术支持。

错误响应​

当 API 请求出错时，除了返回状态码（4xx 或 5xx）外，响应中还会包含错误详情，具体结构如下：

• HTTP 状态行

  • 状态码：用于标识具体错误的 HTTP 状态码，如 404、500。详见下方的 状态码列表。
  • 状态文本：对 HTTP 状态码的简要英文说明，如 Not Found。

• 响应体：包含 errors 字段，用于提供详细的上下文信息，如参数校验失败或业务逻辑错误。

示例：

HTTP/1.1 404 Not Found
{
    "errors": "The product does not exist."
}

状态码列表​

下表列出了 SHOPLINE API 使用的 HTTP 状态码：