https://blog.csdn.net/wolfking0608/article/details/68928451
REST 接口调用成功时返回 HTTP 状态码为 200，返回数据结果为标准 JSON 格式。如调用错误会返回除 200 之外的其他 HTTP 状态码，返回数据结果也为标准 JSON 格式，可根据返回数据中的 error 字段判断具体错误。
例如：
建议对 APP 自己的服务器端调用的环信 REST API 结果做容错处理。比如要 catch 接口调用返回的异常，对于 timeout 这样的错误应该做重试。对于系统级别错误或重试后仍旧出错，应该记录到系统日志，并及时报警提示运维人员做补救措施，如人工补发。
HTTP 状态返回代码 4xx（请求错误）这些状态代码表示请求可能出错，妨碍了服务器的处理。
HTTP 状态返回代码 5xx（服务器错误）这些状态代码表示服务器在尝试处理请求时发生内部错误。
| HTTP 返回码（Status Code） | 说明（Description） |
|---|---|
| 400 | （错误请求）服务器不理解请求的语法。 |
| 401 | （未授权）请求要求身份验证。对于需要token的接口，服务器可能返回此响应。 |
| 403 | （禁止）服务器拒绝请求。对于群组/聊天室服务，表示本次调用不符合群组/聊天室操作的正确逻辑，例如调用添加成员接口，添加已经在群组里的用户，或者移除聊天室中不存在的成员等操作。 |
| 404 | （未找到）服务器找不到请求的接口。 |
| 408 | （请求超时）服务器等候请求时发生超时。 |
| 413 | （请求体过大）请求体超过了5kb，拆成更小的请求体重试即可。 |
| 429 | （服务不可用）请求接口超过调用频率限制，即接口被限流。 |
| 500 | （服务器内部错误）服务器遇到错误，无法完成请求。 |
| 501 | （尚未实施）服务器不具备完成请求的功能。例如，服务器无法识别请求方法时可能会返回此代码。 |
| 502 | （错误网关）服务器作为网关或代理，从上游服务器收到无效响应。 |
| 503 | （服务不可用）请求接口超过调用频率限制，即接口被限流。 |
| 504 | （网关超时）服务器作为网关或代理，但是没有及时从上游服务器收到请求。 |
| HTTP Status Code | Error | Error Description | 可能原因 |
|---|---|---|---|
| 400 | invalid_grant | invalid username or password | 用户名或者密码输入错误 |
| 400 | organization_application_not_found | “Could not find application for easemob-demo/aachatdemoui from URI: easemob-demo/aachatdemoui/users” | 找不到aachatdemoui对应的APP，可能是URL写错了 |
| 400 | illegal_argument | “Entity user requires a property named username” | 创建用户请求体未提供“username” |
| 400 | illegal_argument | “password or pin must provided” | 创建用户请求体未提供“password” |
| 400 | json_parse | “Unexpected character (‘=’ (code 61)): was expecting a colon to separate field name and value\n at [Source: java.io.BufferedInputStream@170e3f35; line: 1, column: 23]” | 发送请求时请求体不符合标准的JSON格式，服务器无法正确解析 |
| 400 | illegal_argument | “password or pin must provided” | 注册用户时json中提供了password但是值为空字符 |
| 400 | duplicate_unique_property_exists | “Application 4d7e4ba0-dc4a-11e3-90d5-e1ffbaacdaf5Entity user requires that property named username be unique, value of dddd exists” | 用户名已存在，dddd这个用户名在该APP下已经存在 |
| 400 | illegal_argument | “newpassword is required” | 修改用户密码的请求体没提供newpassword属性 |
| 400 | illegal_argument | “group member username1 doesn’t exist” | 批量添加群组时预加入群组的新成员username不存在 |
| 401 | unauthorized | “registration is not open, please contact the app admin” | APP的用户注册模式为授权注册，但是注册用户时请求头没带token |
| 401 | auth_bad_access_token | “Unable to authenticate due to corrupt access token” | 发送请求时使用的token错误。注意：不是token过期 |
| 401 | auth_bad_access_token | “Unable to authenticate” | 无效token，符合token的格式，但是该token不是接受请求的系统生成的，系统无法识别该token |
| 401 | “Unable to authenticate due to expired access token” | token过期 | |
| 404 | service_resource_not_found | “Service resource not found” | URL指定的资源不存在 |
| 413 | Request Entity Too Large | “Request Entity Too Large” | 请求体过大，比如超过了5kb，拆成几个更小的请求体重试即可 |
| 429 | reach_limit | “This request has reached api limit” | 超过接口每秒调用次数，加大调用间隔或者联系商务调整限流大小 |
| 500 | no_full_text_index | “Entity ‘user’ with property named ‘username’ is not full text indexed. You cannot use the ‘contains’ operand on this field” | username不支持全文索引，不可以对该字段进行contains操作 |
| 500 | unsupported_service_operation | “Service operation not supported” | 请求方式不被发送请求的URL支持 |
| 500 | web_application | “javax.ws.rs.WebApplicationException” | 错误的请求，给一个未提供的API发送了请求 |
版权声明：本文内容由互联网用户自发贡献，该文观点仅代表作者本人。本站仅提供信息存储空间服务，不拥有所有权，不承担相关法律责任。如发现本站有涉嫌侵权/违法违规的内容， 请联系我们举报，一经查实，本站将立刻删除。
发布者：全栈程序员-站长，转载请注明出处：https://javaforall.net/112340.html原文链接：https://javaforall.net
