# HTTP 状态码

> Shoplazza REST API 返回的 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 速率限制](/docs/app/building-blocks/rest-api/rate-limits)的信息。
      
    

    
      
        **500 Internal Server Error**
      

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