获取翻译语言列表

大约 3 分钟

获取翻译语言列表

功能说明

  • 该接口获取翻译语言列表。
  • 翻译功能由 Microsoft Azure Translation API 提供,开始前请确保你了解该功能支持的目标语言。详见 翻译语言支持open in new window
  • 若要使用该接口,你需要 联系环信商务开通翻译服务

调用频率上限:100 次/秒/App Key

前提条件

要调用环信即时通讯 RESTful API,请确保满足以下要求:

认证方式

环信即时通讯 RESTful API 要求 Bearer HTTP 认证。每次发送 HTTP 请求时,都必须在请求头部填入如下 Authorization 字段:

Authorization: Bearer YourAppToken

为提高项目的安全性,环信使用 Token(动态密钥)对即将登录即时通讯系统的用户进行鉴权。即时通讯 RESTful API 推荐使用 app token 的鉴权方式,详见 使用 App Token 鉴权

HTTP 请求

GET https://{host}/{org_name}/{app_name}/translate/support/language

路径参数

参数类型是否必需描述
hostString环信即时通讯 IM 分配的用于访问 RESTful API 的域名。详见 获取环信即时通讯 IM 的信息
org_nameString环信即时通讯 IM 为每个公司(组织)分配的唯一标识。详见 获取环信即时通讯 IM 的信息
app_nameString你在环信即时通讯云控制台创建应用时填入的应用名称。详见 获取环信即时通讯 IM 的信息

请求 header

参数类型是否必需描述
AuthorizationStringApp 管理员的鉴权 token,格式为 Bearer YourAppToken,其中 Bearer 为固定字符,后面为英文空格和获取到的 app token。

HTTP 响应

响应 body

如果返回的 HTTP 状态码为 200,表示请求成功,响应包体中包含以下字段:

参数类型描述
codeString语言代码。
nameString语言名称。
nativeNameString语言在其起源地的名称,例如,英语在英国称为 English

如果返回的 HTTP 状态码非 200,表示请求失败。你可以参考 错误码 了解可能的原因。

示例

请求示例

curl -X GET "https://XXXX/XXXX/XXXX/translate/support/language"  \
-H "Authorization: Bearer <YourAppToken>" 

响应示例

以下分别是英语、希腊语和马尔代夫语的示例:

  [
    {
      "code": "en",
      "name": "English",
      "nativeName": "English"
    },
    {
      "code": "el",
      "name": "Greek",
      "nativeName": "Ελληνικά"
    },
    {
      "code": "dv",
      "name": "Divehi",
      "nativeName": "ދިވެހިބަސް"
    }
  ]

错误码

如果返回的 HTTP 状态码非 200,表示请求失败,可能提示以下错误码:

HTTP 状态码错误提示可能原因处理建议
400The request has reached the maximum limit调用频率超过限制请联系商务提升频率限制或降低调用频率。
400InternalTranslateFailedExceptionMicrosoft Azure 翻译服务出错。
503service not open翻译服务未开通。翻译服务为增值服务。调用接口前,请先联系商务开通翻译服务。