附录 A 状态代码

Service Desk WS API 请求始终会返回默认响应。响应状态可用于确定请求是否成功。默认响应包括状态代码和关联的状态文本消息。

状态消息是可以显示给用户的中文简要说明。如果显示状态消息，同时也应显示状态代码。

客户端可以识别状态代码，而不是状态消息。当请求无法成功完成时，将返回实际错误或错误消息。此行为会与在此附录中所列的消息略有不同。

某些错误是部分特定调用所特有的，而有些错误则是任何调用中都可能出现的更常见的错误。例如，由于无效凭据而导致访问被拒的状态代码 100。

0xx：成功状态代码	消息
000	成功: 服务器成功处理请求; 服务已返回操作的结果。
001	成功: 服务器成功处理请求; 服务未返回结果。
1xx：授权错误状态代码	消息
100	未授权：由于凭据无效而导致访问被拒。
101	许可错误：您没有相应的许可来使用任何服务。
2xx：操作访问错误状态代码	消息
200	调用错误: 找不到请求的服务的操作定义。
201	调用错误: 请求的服务操作已被禁用。
3xx：操作预处理错误状态代码	消息
300	执行错误: 对 web 服务 {0}.{1} 调用期间传递的请求参数进行数据转换时出现意外错误
301	执行错误: 对 web 服务 {0}.{1} 调用期间传递的请求参数进行数据验证时出现意外错误
4xx：端点执行错误状态代码	消息
400	执行错误：在请求的服务的执行期间在服务端点（提供程序）内发生未处理异常。
401	执行错误: 在请求的服务的执行期间，服务端点(提供程序)捕获了一些错误。
402	执行错误：采用请求的格式呈现服务响应时出现意外错误。
403	执行错误：处理请求的服务时出现意外错误。