差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 后一修订版 两侧同时换到之后的修订记录 | ||
im:other:errorcode:restapi [2018/12/25 09:31] jk 已恢复为旧版 (2018/12/25 07:53) |
im:other:errorcode:restapi [2019/06/14 10:13] jk [索引 错误结果说明] |
||
---|---|---|---|
行 2: | 行 2: | ||
---- | ---- | ||
+ | ===== HTTP 返回结果示例 ===== | ||
+ | REST 接口调用后,HTTP 会状态码以及标准 JSON 格式的返回结果。可根据返回数据中的 error 字段判断具体错误。 | ||
+ | * HTTP 状态返回代码 200(成功) | ||
+ | * HTTP 状态返回代码 4xx(请求错误)这些状态代码表示请求可能出错,妨碍了服务器的处理。 | ||
+ | * HTTP 状态返回代码 5xx(服务器错误)这些状态代码表示服务器在尝试处理请求时发生内部错误。 | ||
- | REST 接口调用成功时返回 HTTP 状态码为 200,返回数据结果为标准 JSON 格式。如调用错误会返回除 200 之外的其他 HTTP 状态码,返回数据结果也为标准 JSON 格式,可根据返回数据中的 error 字段判断具体错误。 | + | ===返回示例 === |
- | + | ||
- | 例如: | + | |
{{:start:450errorcode:response_icon.jpg?nolink|REST API返回错误示例}} | {{:start:450errorcode:response_icon.jpg?nolink|REST API返回错误示例}} | ||
行 11: | 行 14: | ||
建议对 APP 自己的服务器端调用的环信 REST API 结果做容错处理。比如要 catch 接口调用返回的异常,对于 timeout 这样的错误应该做重试。对于系统级别错误或重试后仍旧出错,应该记录到系统日志,并及时报警提示运维人员做补救措施,如人工补发。 | 建议对 APP 自己的服务器端调用的环信 REST API 结果做容错处理。比如要 catch 接口调用返回的异常,对于 timeout 这样的错误应该做重试。对于系统级别错误或重试后仍旧出错,应该记录到系统日志,并及时报警提示运维人员做补救措施,如人工补发。 | ||
- | HTTP 状态返回代码 4xx(请求错误)这些状态代码表示请求可能出错,妨碍了服务器的处理。 | + | ===== 索引 错误状态码===== |
- | + | ||
- | HTTP 状态返回代码 5xx(服务器错误)这些状态代码表示服务器在尝试处理请求时发生内部错误。 | + | |
^HTTP 返回码(Status Code) ^说明(Description)^ | ^HTTP 返回码(Status Code) ^说明(Description)^ | ||
行 29: | 行 30: | ||
|503|(服务器超时)Service Unavailable。| | |503|(服务器超时)Service Unavailable。| | ||
|504|(网关超时)服务器作为网关或代理,但是没有及时从上游服务器收到请求。| | |504|(网关超时)服务器作为网关或代理,但是没有及时从上游服务器收到请求。| | ||
+ | |||
+ | =====索引 错误结果说明 ===== | ||
^HTTP Status Code ^Error ^Error Description ^可能原因^ | ^HTTP Status Code ^Error ^Error Description ^可能原因^ | ||
行 59: | 行 62: | ||
|403||"can not join this group, reason:user %s has joined too many groups/chatroom!"|用户加入群组或聊天室数超过了限制。| | |403||"can not join this group, reason:user %s has joined too many groups/chatroom!"|用户加入群组或聊天室数超过了限制。| | ||
|403||"this appKey has create too many groups/chatrooms!"|appkey下创建的群组或聊天室数量以达到限制。| | |403||"this appKey has create too many groups/chatrooms!"|appkey下创建的群组或聊天室数量以达到限制。| | ||
+ | |403|||没有开通音视频增值服务调用接口失败| | ||
|404|organization_application_not_found|"Could not find application for hx/hxdeo2 from URI: hx/hxdeo2/token"|hx/hxdeo2这个设置不正确或不存在,或baseurl集群设置错误(只针对vip集群的appkey),正确的是orgname/appname,即appkey的"#"换成"/";| | |404|organization_application_not_found|"Could not find application for hx/hxdeo2 from URI: hx/hxdeo2/token"|hx/hxdeo2这个设置不正确或不存在,或baseurl集群设置错误(只针对vip集群的appkey),正确的是orgname/appname,即appkey的"#"换成"/";| | ||
|404|service_resource_not_found|“Service resource not found” |URL指定的资源不存在,如用户相关接口是用户不存在,群组相关接口是群组不存在,聊天室相关接口是聊天室不存在 | | |404|service_resource_not_found|“Service resource not found” |URL指定的资源不存在,如用户相关接口是用户不存在,群组相关接口是群组不存在,聊天室相关接口是聊天室不存在 | |