使用 HTTP
协议访问正在运行 IIS
的服务器上的内容时,服务器将返回一个数字代码,指示请求的结果和响应的性质,包括其成功或失败。
状态代码的第一个数字对响应类进行分类,而最后两位数字没有分类目的。 第一个数字可以是五个值之一:
- 1xx (信息):指示收到请求并继续处理临时响应。
- 2xx (成功):服务器已成功接收并接受客户端请求。
- 3xx (重定向):完成请求需要执行更多作。
- 4xx (客户端错误):发生错误源自客户端浏览器,无法实现。
- 5xx (服务器错误):服务器遇到错误,请求失败。
状态代码
下面是请求可能返回的 HTTP 状态代码。
状态代码 | DESCRIPTION |
---|---|
200 | 成功。 |
400 | 查询参数之一缺失或无效。 请更正请求参数,然后重试。 |
401 | 无法对请求进行身份验证。 请确保凭据已指定且有效。 |
403 | 请求未被授权。 请检查详细错误消息。 此状态代码通常表示你已使用试用订阅提供的所有免费翻译。 |
408 | 无法满足请求,因为缺少资源。 请检查详细错误消息。 当请求包含自定义类别时,此状态代码通常表示自定义翻译系统尚不可用于为请求提供服务。 应在等待一段时间(例如 1 分钟)后重试此请求。 |
429 | 由于客户端已超出请求限制,因此服务器拒绝了请求。 |
500 | 发生意外错误。 如果该错误持续出现,请报告发生故障的日期和时间、响应标头“X-RequestId”中的请求标识符,以及请求标头“X-ClientTraceId”中的客户端标识符。 |
503 | 服务器暂不可用。 重试请求。 如果该错误持续出现,请报告发生故障的日期和时间、响应标头“X-RequestId”中的请求标识符,以及请求标头“X-ClientTraceId”中的客户端标识符。 |
如果发生错误,请求会返回 JSON 错误响应。 错误代码是一个 6 位数的数字,结合了 3 位 HTTP 状态代码,后跟一个 3 位数字,以进一步对错误进行分类:
错误代码
标准错误响应是名为 error
的名称/值对的 JSON 对象。 该值也是具有属性的 JSON 对象:
-
code
:服务器定义的错误代码。 -
message
:一个字符串,提供错误的可读表示形式。
例如,试用订阅的客户在免费配额耗尽后将收到以下错误:
{
"error": {
"code":403001,
"message":"The operation isn't allowed because the subscription has exceeded its free quota."
}
}
错误代码是一个 6 位数字,包括 3 位数的 HTTP 状态代码,后接用于进一步将错误分类的 3 位数。 常见错误代码包括:
代码 | DESCRIPTION |
---|---|
400000 | 某个请求输入无效。 |
400001 | “scope”参数无效。 |
400002 | “category”参数无效。 |
400003 | 语言说明符缺失或无效。 |
400004 | 目标脚本说明符(“To script”)缺失或无效。 |
400005 | 输入文本缺失或无效。 |
400006 | 语言和脚本的组合无效。 |
400018 | 源脚本说明符(“From script”)缺失或无效。 |
400019 | 指定的某个语言不受支持。 |
400020 | 输入文本数组中的某个元素无效。 |
400021 | API 版本参数缺失或无效。 |
400023 | 指定的某个语言对无效。 |
400035 | 源语言(“From”字段)无效。 |
400036 | 目标语言(“To”字段)缺失或无效。 |
400042 | 指定的某个选项(“Options”字段)无效。 |
400043 | 客户端跟踪 ID(ClientTraceId 字段或 X-ClientTraceId 标头)缺失或无效。 |
400050 | 输入文本过长。 查看请求限制。 |
400064 | “translation”参数缺失或无效。 |
400070 | 目标脚本(ToScript 参数)的数目与目标语言(To 参数)的数目不匹配。 |
400071 | TextType 的值无效。 |
400072 | 输入文本的数组包含过多的元素。 |
400073 | 脚本参数无效。 |
400074 | 请求正文是无效的 JSON。 |
400075 | 语言对和类别组合无效。 |
400077 | 超出最大请求大小。 查看请求限制。 |
400079 | 请求用于在源语言与目标语言之间进行翻译的自定义系统不存在。 |
400080 | 语言或脚本不支持音译。 |
401000 | 请求未获得授权,因为凭据缺失或无效。 |
401015 | “提供的凭据适用于语音 API。 此请求需要文本 API 的凭据。 使用 Translator 的订阅。 |
403000 | 不允许此作。 |
403001 | 不允许此作,因为订阅超出了其免费配额。 |
405000 | 请求的资源不支持请求方法。 |
408001 | 正在准备所请求的翻译系统。 请在几分钟后重试。 |
408002 | 等待传入流时请求超时。 客户端没有在服务器准备等待的时间内生成请求。 客户端可以在以后的任何时间重复该请求,而不做任何修改。 |
415000 | Content-Type 标头缺失或无效。 |
429000, 429001, 429002 | 由于客户端已超出请求限制,因此服务器拒绝了请求。 |
500000 | 发生意外错误。 如果错误仍然存在,请报告错误日期/时间、响应标头 X-RequestId 的请求标识符和请求标头 X-ClientTraceId 中的客户端标识符。 |
503000 | 服务暂时不可用。 再重试。 如果错误仍然存在,请报告错误日期/时间、响应标头 X-RequestId 的请求标识符和请求标头 X-ClientTraceId 中的客户端标识符。 |