上传

接口名称：uploadTranslate

接口完整路径：https://www.fanyigou.com/TranslateApi/api/uploadTranslate

接口说明：用户调用接口进行 源文件上传，上传完成后会自动进行翻译，通过tid可以查询翻译的进度等数据。注意：

1.上传格式：pdf、Microsoft Office（doc、docx、dot、dotx、dotm、docm、xml、odt）、WPS Office（wps、wpt）、xls、xlsx、et、ett、ppt、pptx、dps、dpt、txt、rtf

2.上传文件最大50M（如有更高需求请联系销售）

3. 不支持图纸、纯图片文档，加密文件请先去除密码

4.翻译完成后按页从主账号里扣费

5.目前普通账户支持一条翻译通道（即只能同时进行一个文件的上传翻译）,（如有更高需求请联系销售）

调用说明：请求方式：post, file参数请以 multipart/form-data 方式的表单 POST 提交

入参列表：

出参列表：

data结果集：

返回结果:

{"code": 100,"data": {"tid": 14587},"msg": "请求成功"}

下载

接口名称：downloadFile

接口完整路径：https://www.fanyigou.com/TranslateApi/api/downloadFile

接口说明：根据tid下载文档（任务完成才能下载）

入参列表：

出参列表：

说明：1.判断Response Headers 中 detectLanguage 的值，若存在且不为空即为自动检测出的语言（可能为多种语言），仅供参考
2.判断Response Headers 中Content-Type 的值，若包含"application/octet-stream" 则可直接进行下载，否则即为以下返回值

返回结果:

{"code": 312,"msg": "该翻译不存在"}

获取进度

接口名称：queryTransProgress

接口完整路径：https://www.fanyigou.com/TranslateApi/api/queryTransProgress

接口说明：提交翻译完成后可调用此接口实时查询翻译进度或检测页数进度

入参列表：

出参列表：

data结果集：

返回结果:

                                {            "code": 100,            "data": {                "createTime": "2018-03-27 16:57:51",                "docType": "docx",                "fromLan": "",                "msg": "正在翻译",                "pageCount": 1,                "percent": "99.00",                "status": 313,                "tid": 14587,                "title": "测试",                "toLan": "中文",                "updateTime": "2018-03-27 16:58:00"            },            "msg": "请求成功"        }                    

上传文件检测页数

接口名称：detectDocPage

接口完整路径：https://www.fanyigou.com/TranslateApi/api/detectDocPage

接口说明：用户调用接口进行 源文件上传，上传完成后可调用查询进度接口查询页数。注意：

1.上传格式：pdf、Microsoft Office（doc、docx、dot、dotx、dotm、docm、xml、odt）、WPS Office（wps、wpt）、xls、xlsx、et、ett、ppt、pptx、dps、dpt、txt、rtf

2.上传文件最大50M（如有更高需求请联系销售）

3.不支持图纸、纯图片文档，加密文件请先去除密码

4.该功能需联系客服开通

调用说明：请求方式：post, file参数请以 multipart/form-data 方式的表单 POST 提交

入参列表：

出参列表：

data结果集：

返回结果:

{"code": 100,"data": {"tid": 14587,"page",20},"msg": "请求成功"}

检测页数文件提交翻译

接口名称：submitForDetectDoc

接口完整路径：https://www.fanyigou.com/TranslateApi/api/submitForDetectDoc

接口说明：用户调用检测页数接口的文档提交翻译，注意：

同一个tid提交一次翻译即可。

调用说明：请求方式：get,post

入参列表：

出参列表：

返回结果:

{"code": 100,"msg": "请求成功"}

文档转换

接口名称：convert

接口完整路径：https://www.fanyigou.com/TranslateApi/api/convert

接口说明：用户调用接口进行 源文件上传，上传完成后会自动进行转换，通过tid可以查询转换的进度等数据。注意：

1.上传格式：pdf、doc、docx、ppt、pptx、xls、xlsx、hwp、caj、ofd

2.上传文件最大50M （如有更高需求请联系销售）

3.加密文件请先去除密码

4.转换完成后按页从主账号里扣费

调用说明：请求方式：post, file参数请以 multipart/form-data 方式的表单 POST 提交

入参列表：

出参列表：

data结果集：

返回结果:

{"code": 100,"data": {"tid": 14587},"msg": "请求成功"}

回调通知

回调说明：翻译任务、转换任务，失败或成功时会发起回调

请求方式：post, application/json

目前回调地址需要后台设置，后续会开放设置

回调接口处理完成后须返回“success”字符串

回调参数列表：

回调JSON示例:

        {            "createTime":"2021-08-25 14:27:47",            "detectLan":"",            "docType":"pdf",            "fromLan":"中文",            "msg":"完成",            "pageCount":1,            "percent":"100.00",            "status":314,            "tid":19432525,            "title":"test",            "toLan":"英语",            "updateTime":"2021-08-25 14:27:47",            "type":0        }

获取账户信息

接口名称：getAccount

接口完整路径：https://www.fanyigou.com/TranslateApi/api/getAccount

接口说明：获取账户信息

入参列表：

出参列表：

data结果集：

返回结果:

{"code":100,"data":{"deductType":1,"balance":137684},"msg":"请求成功"}

文字翻译

接口名称：trans

接口完整路径：https://www.fanyigou.com/TranslateApi/api/trans

接口说明：

1.待翻译文本字符长度不能超过2000；

2.语言方向：英、日、俄、韩、德、法、意 到中；中、日、俄、韩、德、法、意 到英

调用说明：请求方式：post

入参列表：

出参列表：

data结果集：

返回结果:

{"code":0,"data":{"msg":"翻译成功","transResult":"Test text translation time ","status":314},"msg":"请求成功"}

图片上传

接口名称：uploadTranslateImage

接口完整路径：https://www.fanyigou.com/TranslateApi/api/uploadTranslateImage

接口说明：用户调用接口进行 源文件上传，上传完成后会自动进行翻译，通过tid可以查询翻译的进度等数据。注意：

1.上传格式：jpg、jpeg、png、bmp

2.上传文件最大4M

3.支持15*15 - 2048*2048px尺寸内

4.翻译完成后按页从主账号里扣费

调用说明：请求方式：post, file参数请以 multipart/form-data 方式的表单 POST 提交

入参列表：

出参列表：

data结果集：

返回结果:

{"code": 100,"data": {"tid": 14587},"msg": "请求成功"}

图片翻译获取进度

接口名称：queryImageTransProgress

接口完整路径：https://www.fanyigou.com/TranslateApi/api/queryImageTransProgress

接口说明：提交翻译完成后可调用此接口实时查询翻译进度或检测页数进度

入参列表：

出参列表：

data结果集：

返回结果:

{    "msg": "请求成功",    "code": 0,    "data": {        "tid": 13417,        "createTime": "2022-10-26 11:21:02",        "updateTime": "2022-10-26 11:30:35",        "status": 0,        "title": "5120791b2f0967b54e057dd8af5d87e",        "pageCount": 1,        "percent": "100.00",        "fromLan": "中文","detectLan": "",        "toLan": "英语",        "docType": "png",        "msg": "翻译成功",        "originalCharCount": 0    }}                              

图片翻译下载

接口名称：downloadImage

接口完整路径：https://www.fanyigou.com/TranslateApi/api/downloadImage

接口说明：根据tid下载文档（任务完成才能下载）

入参列表：

出参列表：

说明：1.判断Response Headers 中Content-Type 的值，若包含"application/octet-stream" 则可直接进行下载，否则即为以下返回值

返回结果:

{"code": 312,"msg": "该翻译不存在"}

安全规范

1、签名算法

签名生成的通用步骤如下：

第一步，设所有发送或者接收到的数据为集合M(包括平台生成的privatekey)，将集合M内非空参数值的参数按照参数名ASCII码从小到大排序（字典序），使用URL键值对的格式（即key1=value1&key2=value2…）拼接成字符串stringA。

特别注意以下重要规则：

◆ 参数名ASCII码从小到大排序（字典序）；
◆ 如果参数的值为空不参与签名；
◆ 参数名区分大小写；
◆ 验证调用返回或主动通知签名时，传送的token参数不参与签名，将生成的签名与该token值作校验。
◆ 接口可能增加字段，验证签名时必须支持增加的扩展字段

第二步，对stringA进行MD5运算，再将得到的字符串所有字符转换为大写，得到token值。
◆ privatekey设置路径：翻译狗开发平台-->控制台-->开发者信息-->申请信息

举例：

假设传送的参数如下：

        appid：1522125815142        nonce_str：ibuaiVcKdpRxkhJA        from : en        to : zh        md5 : 5b21f2eeda4726c74274fc27a53bac74        第一步：对参数按照key=value的格式(包括privatekey)，并按照参数名ASCII字典序排序如下：                                    stringA="appid=1522125815142&from=en&md5=5b21f2eeda4726c74274fc27a53bac74&nonce_str=ibuaiVcKdpRxkhJA&privatekey=4892ef64ewf5sffdf&to=zh";        第二步：加密：        token=MD5(stringA).toUpperCase()="31956D481EFF09D7F3EB7C1312BC61E0"         最终得到最终发送的数据：        appid：1522125815142        nonce_str：ibuaiVcKdpRxkhJA        from : en        to : zh        md5 : 5b21f2eeda4726c74274fc27a53bac74        token : 31956D481EFF09D7F3EB7C1312BC61E0                    

2、生成随机数算法

API接口协议中包含字段nonce_str，主要保证签名不可预测。我们推荐生成随机数算法如下：调用随机数函数生成，将得到的值转换为字符串。

协议规则

语言列表

状态码列表

行业列表