API状态码

调用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服务器发生错误原因:服务器内部错误,负载、宕机、堵塞等情况。