垂直领域API接入文档

接入方式

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

签名生成方法

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

生成方法：

Step1. 将请求参数中的 APPID(appid)、翻译query(q，注意为UTF-8编码)、随机数(salt)、支持翻译领域（domain）以及平台分配的密钥(可在管理控制台查看) 按照appid+q+salt+domain+密钥的顺序拼接得到字符串1。
Step2. 对字符串1做md5，得到32位小写的sign。
注：
\1. 待翻译文本（q）需为UTF-8编码；
\2. 在生成签名拼接appid+q+salt+密钥字符串时，q不需要做URL encode，在生成签名之后，发送HTTP请求之前才需要对要发送的待翻译文本字段q做URL encode；
\3. 科技电子、水利机械、网络文学三个领域仅支持中到英，如设置语言方向为英到中，则默认输出通用翻译结果；生物医药、金融财经领域可支持中到英和英到中两种语言方向。

domain领域支持范围：

支持传入值	描述	支持语言方向
electronics	电子科技领域	中文-->英语
finance	金融财经领域	中文-->英语
finance	金融财经领域	英语-->中文
mechanics	水利机械领域	中文-->英语
medicine	生物医药领域	中文-->英语
medicine	生物医药领域	英语-->中文
novel	网络文学领域	中文-->英语

请求参数

Body 参数application/x-www-form-urlencoded

string

必需

请求翻译query（UTF-8编码）

from

string

必需

翻译源语言（可设置为auto）

string

必需

翻译目标语言（不可设置为auto）

appid

string

必需

APPID（可在管理控制台查看）

示例值:

salt

string

必需

随机数（可为字母或数字的字符串）

示例值:

domain

string

必需

翻译领域类型（具体见下表）

sign

string

必需

签名（appid+q+salt+密钥的MD5值）

示例值:

示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Body

from

string

源语言

必需

返回用户指定的语言，或者自动检测出的语种（源语言设为 auto 时）

string

目标语言

必需

返回用户指定的目标语言

trans_result

string

翻译结果

必需

返回翻译结果，包括 src 和 dst 字段

trans_result.*.src

string

原文

必需

接入举例中的“amyotrophic lateral sclerosis”

trans_result.*dst

string

译文

必需

接入举例中的“肌萎缩性侧束硬化症”

error_code

string

错误码

必需

仅当出现错误时显示

示例

成功示例异常示例

{
    "from": "en",
    "to": "zh",
    "trans_result": [
        {
            "src": "apple",
            "dst": "苹果"
        }
    ]
}

接入方式#

签名生成方法#

生成方法：#

domain领域支持范围：#

请求参数

示例代码

返回响应

接入方式

签名生成方法

生成方法：

domain领域支持范围：