差别
这里会显示出您选择的修订版和当前版本之间的差别。
两侧同时换到之前的修订记录 前一修订版 后一修订版 | 前一修订版 后一修订版 两侧同时换到之后的修订记录 | ||
im:other:errorcode:restapi [2018/12/25 09:31] jk 已恢复为旧版 (2018/12/25 07:53) |
im:other:errorcode:restapi [2018/12/25 09:40] she |
||
---|---|---|---|
行 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 ^可能原因^ |