Logo Site EngageLab Full Black
联系销售

HTTP 状态码

本文档定义 MTPush REST API 的 HTTP 返回码规范。

MTPush Push API v4 新版本 API 满足此规范。

状态码定义

Code 描述 详细解释
200 OK Success!
400 错误的请求 该请求是无效的。相应的描述信息会说明原因。
401 未验证 没有验证信息或者验证失败
403 被拒绝 理解该请求,但不被接受。相应的描述信息会说明原因。
404 无法找到 资源不存在,请求的用户的不存在,请求的格式不被支持。
405 请求方法不合适 该接口不支持该方法的请求。
410 已下线 请求的资源已下线。请参考相关公告。
429 过多的请求 请求超出了频率限制。相应的描述信息会解释具体的原因。
500 内部服务错误 服务器内部出错了。请联系我们尽快解决问题。
502 无效代理 业务服务器下线了或者正在升级。请稍后重试。
503 服务暂时失效 服务器无法响应请求。请稍后重试。
504 代理超时 服务器在运行,但是无法响应请求。请稍后重试。

遵守的规范

  • HTTP 200 表示该请求已被处理,不保证批量单推中的每个目标都成功。必须逐项检查 results[目标].success,失败时读取该项的 error.code。
  • 请求级业务错误使用相应的 4xx 状态码;批量单推整体限流返回 HTTP 400,逐项限流错误 23008 则可包含在 HTTP 200 的响应体中。
  • 请求级服务器内部错误,无特别错误码使用 500。
  • 业务异常时,返回内容使用 JSON 格式定义 error 信息。
Icon Solid Transparent White Qiyu
联系销售