上传

接口名称：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/image/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": {"taskId": 14587},"msg": "请求成功"}

图片翻译获取进度

接口名称：queryImageTransProgress

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

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

入参列表：

出参列表：

data结果集：

返回结果:

{
        "msg": "请求成功",
        "code": 100,
        "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/image/downloadImage

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

入参列表：

出参列表：

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

返回结果:

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

OCR上传

接口名称：ocrUploadImage

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

接口说明：用户调用接口进行 源文件上传，上传完成后会自动进行识别并返回数据。注意：

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

2.上传文件最大4M

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

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

入参列表：

出参列表：

data结果集：

返回结果:

{"msg":"请求成功","code":100,"data":{"words_result":[{"words":"X Headers","location":{"top":0,"left":47,"width":96," height":10}}],"words_result_num":9}} 

词典搜索

接口名称：dict/search

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

入参列表：

出参列表：

data结果集：

返回结果:

{"msg":"请求成功","code":100,"data":{"dict":{"base":{"explain":{"word_means":[{"part":"n.","means":["入口，通道","（使用或见到的）机会/权利"]},{"part":"v.","means":["访问，存取（计算机信息）","到达，进入，使用"]}],"case_word":["ACCESS"]},"explain_zh":"","exchange":{"word_ing":["accessing"],"word_done":["accessed"],"word_past":["accessed"],"word_third":["accesses"],"word_pl":[]},"pron_zh":"","pron_am":{"text":"ˈækses","pronounce":""},"pron_en":{"text":"ˈækses","pronounce":""},"word":"access","chinese":false},"practical_sentences":[],"true_sentences":[{"tag":"四级","sentences":[]},{"tag":"六级","sentences":[]},{"tag":"高考","sentences":[{"text":"Depending on which role you choose, you could help to increase a community's access to safe drinking water, or help to protect valuable local cultures.","text_cn":"","source":"2019年高考英语北京卷 阅读理解 阅读A 原文"},{"text":"Designers have also created informal gathering places, and upgraded employees' access to heavily trafficked areas such as copy and coffee rooms.","text_cn":"","source":"2015年高考英语上海卷 选词填空 原文"},{"text":"Instead, computer users are developing stronger transactive memories; that is, people are learning how to organize huge quantities of information so that they are able to access it at a later date.","text_cn":"","source":"2015年高考英语安徽卷 阅读理解 阅读C 原文"},{"text":"It was really annoying; I couldn't get access to the data bank you had recommended.","text_cn":"","source":"2016年高考英语天津卷 单项填空 原文"},{"text":"One crucial factor is secure access to land.","text_cn":"","source":"2018年高考英语江苏卷 阅读理解 阅读C 原文"},{"text":"People have better access to health care than they used to, and they're living longer as a result.","text_cn":"","source":"2017年高考英语北京卷 单项填空 原文"},{"text":"Some also contain cd-roms and access to special online features.","text_cn":"","source":"2015年高考英语湖南卷 任务型读写 原文"},{"text":"Thus I have been allowed to gain access to their living environment.","text_cn":"","source":"2016年高考英语四川卷 阅读理解 阅读C 原文"},{"text":"Thus, the keyboard can determine people's identities, and by extension, whether they should be given access to the computer it's connected to—regardless of whether someone gets the password right.","text_cn":"","source":"2019年高考英语全国卷I 阅读理解 阅读C 原文"},{"text":"We need a better way to access information.","text_cn":"","source":"2015年高考英语安徽卷 阅读理解 阅读C 选项"}]},{"tag":"考研","sentences":[{"text":"Not only did they develop such a device but by the turn of the millennium they had also managed to embed it in a worldwide system accessed by billions of people every day.","text_cn":"","source":"出自-2012年考研阅读原文"},{"text":"When we don't understand the value of mental health and we don't know how to gain access to it, mental health will remain hidden from us.","text_cn":"","source":"出自-2016年考研翻译原文"},{"text":"The charter’s main tool of enforcement is to deny access for designers and modeling agencies to Copenhagen Fashion Week ( ' , CFW), which is run by the Danish Fashion Institute.","text_cn":"","source":"出自-2016年考研阅读原文"},{"text":"Rather officials must avoid double standards, or different types of access for average people and the wealthy.","text_cn":"","source":"出自-2017年考研阅读原文"},{"text":"Merely helping a gift-giver gain access to other officials, unless done with clear intent to pressure those officials, is not corruption, the justices found.","text_cn":"","source":"出自-2017年考研阅读原文"},{"text":"Favoritism in official access can fan public perceptions of corruption.","text_cn":"","source":"出自-2017年考研阅读原文"},{"text":"But the ruling reinforces the need for citizens and their elected representatives, not the courts, to ensure equality of access to government.","text_cn":"","source":"出自-2017年考研阅读原文"},{"text":"But it did so while holding its nose at the ethics of his conduct, which included accepting gifts such as a Rolex watch and a Ferrari automobile from a company seeking access to government.","text_cn":"","source":"出自-2017年考研阅读原文"},{"text":"But it did so while holding its nose at the ethics of his conduct, which included accepting gifts such as a Rolex watch and a Ferrari Automobile from a company seeking access to government.","text_cn":"","source":"2017年考研真题（英语一）阅读理解 Section Ⅱ"},{"text":"Critics make three main arguments against gene patents: a gene is a product of nature, so it may not be patented; gene patents suppress innovation rather than reward it; and patents'monopolies restrict access to genetic tests such as Myriad's.","text_cn":"","source":"2012年考研真题（英语二）阅读理解 Section Ⅱ"},{"text":"In Britain the move towards open access publishing has been driven by funding bodies.","text_cn":"","source":"2020年考研真题（英语一）阅读理解 Section Ⅱ"},{"text":"It can't when so many more employers have so much more access to so much more above average cheap foreign labor, cheap robotics, cheap software, cheap automation and cheap genius.","text_cn":"","source":"2013年考研真题（英语二）阅读理解 Section Ⅱ"},{"text":"Merely helping a gift-giver gain access to other officials, unless done with clear intent to pressure those officials, is not corruption, the Justices found.","text_cn":"","source":"2017年考研真题（英语一）阅读理解 Section Ⅱ"},{"text":"More than half of all British scientific research is now published under open access terms: either freely available from the moment of publication, or paywalled for a year or more so that the publishers can make a profit before being placed on general rel","text_cn":"","source":"2020年考研真题（英语一）阅读理解 Section Ⅱ"},{"text":"The charter's main tool of enforcement is to deny access for designers and modeling agencies to Copenhagen Fashion Week, which is run by the Danish Fashion Institute.","text_cn":"","source":"2016年考研真题（英语一）阅读理解 Section Ⅱ"},{"text":"The Dutch giant Elsevier, which claims to publish 25% of the scientific papers produced in the world, made profits of more than £900m last year, while UK universities alone spent more than £210m in 2016 to enable researchers to access their own publicly f","text_cn":"","source":"2020年考研真题（英语一）阅读理解 Section Ⅱ"},{"text":"The fact that this is not an uncommon occurrence means that dishonest persons might be able to access bank accounts in electronic payments systems and steal from someone else's accounts.","text_cn":"","source":"2013年考研真题（英语二）完形填空 Section Ⅰ"},{"text":"The most drastic, and thoroughly illegal, reaction has been the emergence of Sci-Hub, a kind of global photocopier for scientific papers, set up in 2012, which now claims to offer access to every paywalled article published since 2015.","text_cn":"","source":"2020年考研真题（英语一）阅读理解 Section Ⅱ"},{"text":"There are concerns that government, employers, and marketers might be able to access these data, thereby violating our privacy.","text_cn":"","source":"2013年考研真题（英语二）完形填空 Section Ⅰ"},{"text":"We often hear media reports that an unauthorized hacker has been able to access a computer database and to alter information stored there.","text_cn":"","source":"2013年考研真题（英语二）完形填空 Section Ⅰ"}]}],"ee_means":[],"roots_affixes":[],"phrases":[],"synonym":[{"part":"n.","word_means":[{"mean":"接近的机会","words":["of","way","entry","approach"]}]},{"part":"","word_means":[{"mean":"其他释义","words":["advent","retirement","admission","course","license","retreat","passport","accession","approach","door"]}]}],"antonym":[{"part":"n.","word_means":[{"mean":"接近;进入","words":["retirement","retreat"]}]}],"industry_dict":[],"synonym_explain":[],"collins":[{"entries":[{"define":"If you have access to a building or other place, you are able or allowed to go into it.","trans":"进入（权）；通道;入径","part":"N-UNCOUNT","sentences":[{"origin":"The facilities have been adapted to give access to wheelchair users.","trans":"这些设施已经改造过以方便轮椅使用者进入。"},{"origin":"Scientists have only recently been able to gain access to the area...","trans":"科学家直到最近才得以进入该地区。"}]},{"define":"If you have access to something such as information or equipment, you have the opportunity or right to see it or use it.","trans":"查阅（或使用）的机会（或权利）","part":"N-UNCOUNT","sentences":[{"origin":"...a Code of Practice that would give patients right of access to their medical records.","trans":"允许病人查看自己病历的职业准则"},{"origin":"...whether one has access to a dish and the other accoutrements needed to watch satellite TV.","trans":"是否能使用碟型卫星天线以及其他观看卫星电视所需要的装备"}]},{"define":"If you have access to a person, you have the opportunity or right to see them or meet them.","trans":"接近（或面见）的机会（或权利）","part":"N-UNCOUNT","sentences":[{"origin":"He was not allowed access to a lawyer.","trans":"他未被获准见律师。"},{"origin":"My ex-wife deliberately sabotages my access to the children.","trans":"我的前妻蓄意阻挠我见孩子。"}]},{"define":"If you access something, especially information held on a computer, you succeed in finding or obtaining it.","trans":"存取，访问(计算机信息）","part":"VERB","sentences":[{"origin":"You've illegally accessed and misused confidential security files.","trans":"你已经非法访问并盗用了机密的安全文件。"}]}]}]}}}

安全规范

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，主要保证签名不可预测。我们推荐生成随机数算法如下：调用随机数函数生成，将得到的值转换为字符串。

协议规则

语言列表

状态码列表

行业列表