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