通用状态码说明
本文档描述了 AegisSpeed Server API 中使用的所有状态码,包括 HTTP 状态码和业务状态码。
HTTP 状态码
| 状态码 | 说明 |
|---|---|
| 200 | 请求成功 |
| 401 | 未授权,token 无效或过期 |
| 403 | 服务器未开放此接口 |
| 500 | 服务器内部错误 |
业务状态码
通用状态码
| 状态码 | 说明 |
|---|---|
| 00000 | 服务器未开放接口 |
| 10000 | 操作成功 |
用户认证状态码
| 状态码 | 说明 |
|---|---|
| 10001 | 身份验证失败 / 用户名或密码不正确 / token 无效 |
| 10002 | 用户不存在 |
用户注册状态码
| 状态码 | 说明 |
|---|---|
| 10001 | 用户身份证号不合法 |
| 10002 | 用户姓名不合法 |
| 10003 | 用户手机号不合法 |
| 10004 | 用户邮箱不合法 |
| 10005 | 用户身份证已被注册 |
| 10006 | 用户手机号已被注册 |
| 10007 | 用户邮箱已被注册 |
状态码使用指南
成功响应
所有成功的请求都会返回 HTTP 200 状态码,响应体中包含操作结果。
{
"status": 200,
"code": "10000",
"result": "操作成功",
"data": {}
}
认证失败
当 token 无效或过期时,返回 HTTP 401 状态码。
{
"status": 401,
"code": "10001 : token 已过期或无效",
"result": "获取失败",
"data": {}
}
接口未开放
当接口被禁用或未开放时,返回 HTTP 403 状态码。
{
"status": 403,
"code": "00000",
"result": "服务器未开放此接口",
"data": {}
}
信息
HTTP 状态码表示 HTTP 协议的响应状态,业务状态码(code)表示接口返回的具体业务结果。