通用状态码说明

本文档描述了 AegisSpeed Server API 中使用的所有状态码，包括 HTTP 状态码和业务状态码。

---

HTTP 状态码

状态码	说明
200	请求成功
400	请求参数不合法
401	未授权，token 无效或过期
403	服务器未开放此接口
404	资源不存在
409	资源冲突
500	服务器内部错误

---

业务状态码

通用状态码

状态码	说明
00000	服务器未开放接口
10000	操作成功

用户认证状态码

状态码	说明
10001	身份验证失败 / 用户名或密码不正确 / token 无效
10002	用户不存在

用户注册状态码

状态码	说明
10001	用户身份证号不合法
10002	用户姓名不合法
10003	用户手机号不合法
10004	用户邮箱不合法
10005	用户身份证已被注册
10006	用户手机号已被注册
10007	用户邮箱已被注册
10008	服务器未开放此接口
10009	注册失败，服务器内部错误

用户登录状态码

状态码	说明
10001	用户名或密码不正确
10002	用户不存在
10003	服务器未开放此接口
10004	登录失败，服务器内部错误

用户信息状态码

状态码	说明
10001	token 已过期或无效
10002	服务器未开放此接口
10003	获取用户信息失败，服务器内部错误
10004	获取历史检查信息失败，服务器内部错误

用户修改状态码

状态码	说明
10001	token 已过期或无效
10002	服务器未开放此接口
10003	手机号已被其他用户使用
10004	修改失败，服务器内部错误

机器信息状态码

状态码	说明
10001	服务器未开放此接口 / 用户身份证号不合法 / 机器码已被注册
10002	用户身份证号不合法 / 服务器未开放此接口
10003	用户不存在 / 获取机器信息失败，服务器内部错误
10004	机器码已被注册
10005	绑定失败，服务器内部错误

机器校验状态码

状态码	说明
10000	机器码未绑定
10001	服务器未开放此接口
10002	机器码已绑定在该用户下 / 用户身份证号不合法
10003	机器码已绑定

作弊检测状态码

状态码	说明
10000	用户名下未发现作弊记录
10001	token 已过期或无效
10002	服务器未开放此接口
10003	用户已被标记为作弊人员

---

状态码使用指南

成功响应

所有成功的请求都会返回 HTTP 200 状态码，响应体中包含操作结果。

{
    "status": 200,
    "code": "10000",
    "result": "操作成功",
    "data": {}
}

认证失败

当 token 无效或过期时，返回 HTTP 401 状态码。

{
    "status": 401,
    "code": "10001",
    "result": "token 已过期或无效",
    "data": {}
}

接口未开放

当接口被禁用或未开放时，返回 HTTP 403 状态码。

{
    "status": 403,
    "code": "00000",
    "result": "服务器未开放此接口",
    "data": {}
}

---

信息

HTTP 状态码表示 HTTP 协议的响应状态，业务状态码（code）表示接口返回的具体业务结果。

---

← 返回 API 文档首页