调用API接口失败时,会返回接口调用HTTP状态码。
常见接口调用成功码和错误码、错误信息和解决方案,请参见下表:
| 状态码(Status Code) | 错误信息(Error) | 原因及解决方案 |
| 200 | 表示接口调用成功。 | |
| 201 | 示新增或修改成功。 | |
| 202 | 表示一个请求已经进入后台排队(异步任务)。 | |
| 204 | 表示删除数据成功。 | |
| 400 | 发出的请求有错误,服务器没有进行查询、新建或修改数据的操作 | 原因:常见于请求参数验证错误。 解决方案:查看接口响应参数内 error 字段错误信息来进行解决。 |
| 401 | 调用的接口需要用户登陆后才能使用 | 原因:Token失效,或登录时传入的设备类型( Device-Type )和请求时候不匹配。 解决方案:如果是Token失效请重新调用用户登录接口服务获取新的Token,如果是设备类型( Device-Type )不匹配请修改对应的值。 注意: 设备类型( Device-Type )不能随便传入,请开发人员根据自己开发的端进行传入,比如开发的是web端就传入web。 |
| 403 | 表示用户未得到授权,访问是被禁止的 | 原因:用户没有权限访问接口。 解决方案:管理员分配权限给登录的用户。 |
| 404 | 请求的资源不存在 | 原因:请求的资源不存在或请求的资源为空。 |
| 410 | 请求的资源被删除 | 原因:请求的资源被永久删除,且不会再得到的。 |
| 500 | 服务器发生错误 | 原因:服务器内部错误,负载、宕机、堵塞等情况。 |