状态码

请求发送以后,您会收到响应,包含状态码、响应消息头和消息体。

状态码是一组从1xx到5xx的数字代码,状态码表示了请求响应的状态,完整的状态码列表请参见状态码

对于登录接口,如果调用后返回状态码为“201”,则表示请求成功。

响应消息体

响应消息体通常以结构化格式JSON返回。

对于登录接口,返回如下消息体。

{
  "token": "9008969039464a879cc220d011ff147e",
  "userId": "2019011500000061",
  "mobile": "137*****831",
  "email": "zui********@xxx.com",
  "name": ""
}

当接口调用出错时,会返回错误码及错误信息说明,错误响应的Body体格式如下所示。

字段名 说明
code 错误码
message 返回错误信息描述
status 状态码
timestamp 时间戳
path 请求路径
requestID 请求ID,用户日志追踪

Json示例:

{
  "error": {
    "code": "PARAMETER_INVALID",
    "message": "登录账号不能为空",
    "status": 400,
    "timestamp": "2024-08-03T03:46:21.619+00:00",
    "path": "/apis/token/v1/tokens",
    "requestID": "584fea7567b24ee2bbb7ff13297cf778"
  }
}
作者:叶奕珺  创建时间:2024-08-03 08:47
最后编辑:叶奕珺  更新时间:2025-04-29 18:46