数美智能文本翻译API接口文档#
版权所有 翻版必究
检测提交接口#
接口说明#
该接口为文本翻译提交接口，支持http协议接口调用
请求URL#
| 集群名称 | url |
|---|---|
| 上海集群 | https://api-translate-sh.fengkongcloud.com/translate/v1 |
检测数据要求#
请求体限制：所有请求的文本原文内容不超过2k，utf-8字符判断
文本要求#
- 文本限制：数组长度不超过100，所有请求的文本原文内容整体不超过2k，utf-8字符判断
请求参数#
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| accessKey | string | Y | 公司秘钥，联系数美提供 |
| appId | string | Y | 用于区分应用，需要联系数美服务开通，请使用数美单独提供的传值为准 |
| data | json_object | Y | 请求数据 |
data里包含的内容
| 名称 | 类型 | 是否必填 | 说明 |
|---|---|---|---|
| textArray | string_array | Y | 支持传文本数组进行翻译： 1：数组最大长度为100个，len(textArray)大于100返回1902 2：所有数组的字符串内容小于2k，len(textArray[index])大于2k返回1902，每个字符串内容大于128会切分后进行翻译，翻译后拼接从接口返回，如果翻译失败，则返回原文内容 内部按照3并发进行审核，每个并发处理字数为128字，具体的耗时和请求的数组长度和每个数组内容中字符串的长度有关，例如： [" Bonjour", "hello", "こんにちは", "안녕하세요"] |
| from | json_object | Y | 源语言， 可设置为auto，识别的语种范围见源语言语种，不在范围内，错误码code返回1902 |
| to | json_object | Y | 目标语言，目前只支持中文，具体值如下 |
源语言：
| 语言 | 代码 |
|---|---|
| 中文 | zh |
| 英文 | en |
| 现代标准阿拉伯语 | ar |
| 埃及阿拉伯语 | arz |
| 孟加拉语 | bn |
| 标准藏语 | bo |
| 保加利亚语 | bg |
| 捷克语 | cs |
| 丹麦语 | da |
| 德语 | de |
| 希腊语 | el |
| 英语 | en |
| 芬兰语 | fi |
| 法语 | fr |
| 古吉拉特语 | gu |
| 希伯来语 | he |
| 印地语 | hi |
| 克罗地亚语 | hr |
| 匈牙利语 | hu |
| 印尼语 | id |
| 意大利语 | it |
| 日语 | ja |
| 卡纳达语 | kn |
| 高棉语 | km |
| 韩语 | ko |
| 老挝语 | lo |
| 马拉雅拉姆语 | ml |
| 马拉地语 | mr |
| 荷兰语 | nl |
| 挪威尼诺斯克语 | no |
| 西波斯语 | fa |
| 波兰语 | pl |
| 葡萄牙语 | pt |
| 罗马尼亚语 | ro |
| 俄语 | ru |
| 斯洛伐克语 | sk |
| 西班牙语 | es |
| 瑞典语 | sv |
| 泰米尔语 | ta |
| 泰卢固语 | te |
| 菲律宾语(塔加洛语) | tl |
| 泰语 | th |
| 土耳其语 | tr |
| 维吾尔语 | ug |
| 乌克兰语 | uk |
| 乌尔都语 | ur |
| 北乌兹别克语 | uz |
| 越南语 | vi |
| 粤语 | yue |
| 简体中文 | zh |
| 标准马来语 | ms |
| 自动识别 | auto |
目标语言可选值：
| 语言 | 代码 |
|---|---|
| 中文 | zh |
返回参数
放在HTTP Body中，采用Json格式，具体参数如下：
| 参数名称 | 类型 | 是否必选 | 说明 |
|---|---|---|---|
| requestId | string | Y | 本次请求数据的唯一标识,用于问题排查和效果优化，强烈建议保存 |
| code | int | Y | 1100：成功 1901：QPS超限 1902：参数不合法 1903：服务失败 9101：无权限操作 |
| message | string | Y | 返回码详情描述：和code对应：成功 QPS超限 参数不合法 服务失败 无权限操作 |
| translateResultsArray | string_array | N | 翻译结果 |
示例#
上传接口请求示例：#
{ "accessKey": "数美申请获得", "appId": "default", "data": { "textArray": [ " Bonjour", "hello", "こんにちは", "안녕하세요" ], "from": "auto", "to": "zh" } }
上传接口返回示例：#
{ "code": 1100, "message": "success", "requestId": "88811b54f17cbee9d4dd2fdaacb5bf88", "translateResultsArray": [ "你好", "你好", "你好", "你好" ] }
