Azure AI 翻译器响应代码和消息

使用 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 中的客户端标识符。