接入方式

通用翻译API通过HTTP接口对外提供多语种互译服务。您只需要通过调用通用翻译API，传入待翻译的内容，并指定要翻译的源语言（支持源语言语种自动检测）和目标语言种类，就可以得到相应的翻译结果。

通用翻译API HTTP地址：

http://tapi.iol8.com/mt/GetTranslate

您需要向该地址通过POST或GET方法发送下列字段来访问服务

字段名	类型	必填参数	描述	备注
source	TEXT	Y	请求翻译query	UTF-8编码
srcLang	TEXT	N	翻译源语言	语言列表(可不传 自动检测)
tarLang	TEXT	Y	译文语言	语言列表
appKey	TEXT	Y	APP Key	可在管理控制台查看
timeStamp	TEXT	Y	时间戳(毫秒数)
sign	TEXT	Y	签名	appid+q+salt+密钥 的MD5值
engine	TEXT	N	引擎	参照引擎列表(可不传 自动选择)

签名是为了保证调用安全，使用MD5算法生成的一段字符串，生成的签名长度为32位，签名中的英文字符均为小写格式

为保证翻译质量，请将单次请求长度控制在 6000 bytes以内。（汉字约为2000个）

签名生成方法如下：

1、将请求参数中的 appKey, 翻译 source(source, 注意为UTF-8编码), 时间戳(timeStamp), 及平台分配的appKey和密钥(可在管理控制台查看)

按照ASCII 码表的顺序排列参数名,拼接得到字符串L。

2、对字符串L做md5，得到32位小写的sign。

注意:

1、请先将需要翻译的文本转换为UTF-8编码

2、在生成签名拼接 appid+q+salt+密钥 字符串时，q不需要做URL encode。

返回结果是json格式，包含以下字段：

字段名	类型	描述
result	TEXT	翻译结果1 翻译成功
errorCode	TEXT	翻错误状态码（详情参照错误码表）
errorDetail	TEXT	错误详情信息
errorMsg	TEXT	错误信息
data	TEXT	翻译数据对象
tarContent	TEXT	翻译结果

例：将apple从英文翻译成中文：

请求参数：

appKey=XXXXXX

appSecret=YYYYYY (平台分配的密匙)

engine=BAIDU

source=apple (原文)

srcLangId=en

tarLangId=zh

timeStamp=14502423423434

生成sign：

>拼接字符串L

按照ASCII 码表的顺序排列参数名,拼接得到字符串L

拼接 appKey=XXX&appSecret=密钥&engine=BAIDU&source=apple&srcLangId=1&tarLangId=2&timeStamp=14502423

得到字符串 L = appKey=XXX&appSecret=YYY&engine=BAIDU&source=apple&srcLangId=1&tarLangId=2&timeStamp=14502423

>计算签名sign

对字符串L做md5加密，注意计算md5之前，串L必须为UTF-8编码

sign=md5(appKey=XXX&appSecret=YYY&engine=BAIDU&source=apple&srcLangId=1&tarLangId=2&timeStamp=14502423)

sign=2nrfi0ds092nnf23fj0svnsfmvbkccbscx

完整请求为：

http://tapi.iol8.com/mt/GetTranslate?

appKey=XXX&engine=BAIDU&source=apple&srcLangId=1&tarLangId=2&timeStamp=14502423&sign=2nrfi0ds092nnf23fj0svnsfmvbkccbscx

也可以使用POST方法传送需要的参数。

语言列表

返回结果是json格式，包含以下字段：

引擎	语种	描述
DEFAULT （通用）	英文-en,日文-ja,法文-fr,德文-de,俄文-ru,韩文-ko,西班牙文-es,葡萄牙语-pt,维吾尔语-uy,泰语-th,蒙古语-mo,藏语-ti	引擎支持以下所有语种和中文-zh互译
GOOGLE （谷歌）	英文-en,日文-ja,法文-fr	引擎支持以下所有语种和中文-zh互译
BAIDU （百度）	英文-en	引擎支持以下所有语种和中文-zh互译
YOUDAO （有道）	英文-en	引擎支持以下所有语种和中文-zh互译
XINYI （新意）	英文-en,日文-ja,法文-fr,德文-de,俄文-ru,韩文-ko,西班牙文-es,葡萄牙语-pt	引擎支持以下所有语种和中文-zh互译
XIAONIU（小牛）	英文-en,日文-ja,韩文-ko,维吾尔语-uy,泰语-th,蒙古语-mo,藏语-ti	引擎支持以下所有语种和中文-zh互译
TENCENT（腾讯）	英文-en	引擎支持以下所有语种和中文-zh互译

错误码列表

当翻译结果无法正常返回时，请参考下表处理：

错误码	含义	解决方法
000000	服务器繁忙	重试
000001	参数为空	检查您是否少传参数
000002	无法识别原文语种	请您传入原文语种
000003	余额不足	请您为账户充值
000004	没有对应的翻译引擎	检查您的引擎参数是否有误
000005	没有此翻译引擎的权限，请申请	检查您的翻译引擎是否已申请
000006	签名错误	检查您的 appid 是否正确，或者服务是否开通和您的签名生成方法
000007	该引擎没有此语种方向	检查译文语言是否在语言列表里