获取翻译语言列表
大约 3 分钟
REST API
获取翻译语言列表
功能说明
- 该接口获取翻译语言列表。
- 翻译功能由 Microsoft Azure Translation API 提供,开始前请确保你了解该功能支持的目标语言。详见 翻译语言支持。
- 若要使用该接口,你需要 联系环信商务开通翻译服务。
调用频率上限:100 次/秒/App Key
前提条件
要调用环信即时通讯 RESTful API,请确保满足以下要求:
- 已在环信即时通讯控制台 开通配置环信即时通讯 IM 服务。
- 了解环信 IM 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
路径参数
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
host | String | 是 | 环信即时通讯 IM 分配的用于访问 RESTful API 的域名。详见 获取环信即时通讯 IM 的信息。 |
org_name | String | 是 | 环信即时通讯 IM 为每个公司(组织)分配的唯一标识。详见 获取环信即时通讯 IM 的信息。 |
app_name | String | 是 | 你在环信即时通讯云控制台创建应用时填入的应用名称。详见 获取环信即时通讯 IM 的信息。 |
请求 header
参数 | 类型 | 是否必需 | 描述 |
---|---|---|---|
Authorization | String | 是 | App 管理员的鉴权 token,格式为 Bearer YourAppToken ,其中 Bearer 为固定字符,后面为英文空格和获取到的 app token。 |
HTTP 响应
响应 body
如果返回的 HTTP 状态码为 200
,表示请求成功,响应包体中包含以下字段:
参数 | 类型 | 描述 |
---|---|---|
code | String | 语言代码。 |
name | String | 语言名称。 |
nativeName | String | 语言在其起源地的名称,例如,英语在英国称为 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 状态码 | 错误提示 | 可能原因 | 处理建议 |
---|---|---|---|
400 | The request has reached the maximum limit | 调用频率超过限制 | 请联系商务提升频率限制或降低调用频率。 |
400 | InternalTranslateFailedException | Microsoft Azure 翻译服务出错。 | |
503 | service not open | 翻译服务未开通。 | 翻译服务为增值服务。调用接口前,请先联系商务开通翻译服务。 |