1.6 HTTP方式调用
优质
小牛编辑
118浏览
2023-12-01
说明
使用HTTP方式需要在请求头里添加验证信息,见鉴权页。
翻译
请求URL
/api/v1/translation/text?source=combine
请求方法
POST
Header
Content-Type application/json
body请求体
{
"appId":"your_app_name",
"requestId":"c6031ff2-3342-4999-89ab-000000000000",
"from":"en",
"to":"zh-chs",
"engine":"TENCENT",
"query":"good",
"action":"dict"
}
请求参数说明
参数名 | 是否必选 | 类型 | 说明 |
---|---|---|---|
appId | 是 | string | 第三方app名 |
requestId | 是 | string | 请求UUID |
from | 是 | string | 源语言代号(可设置为auto) |
to | 是 | string | 目标语言代号 |
engine | 否 | string | 设置翻译引擎(AZURE/TENCENT/BAIDU/MINMT) |
query | 是 | string | 待翻译字段 |
action | 否 | string | 取值为字典("dict")或者文本("text"),不指定时翻译服务会进行简单判断 |
支持的语言列表
zh-chs 中文
en 英文
fr 法语
de 德语
es 西班牙语
ja 日语
ko 韩语
hi 有印地语
.
返回结果:
{
"engine": "TENCENT",
"status": 0,
"quickAppUrl": "https://dictweb.translator.qq.com/?id=44d35c0d5b0bb0252821f55f432a3c59",
"landingPageUrl": "https://dictweb.translator.qq.com/?id=44d35c0d5b0bb0252821f55f432a3c59",
"basic": {
"explains": [
"adj.合意的,满意的",
"n.善;正义",
"adv.好地"
]
},
"translation": [
"合意的,满意的"
],
"requestId": "c6031ff2-3342-4999-89ab-000000000000"
}
返回字段说明
参数名 | 是否必选 | 类型 | 说明 |
---|---|---|---|
status | 是 | int | 返回正常为0,不正常-1 |
engine | 是 | string | 使用的翻译引擎 |
requestId | 是 | string | 请求对应的UUID |
quickAppUrl | 否 | string | 快应用地址 |
landingPageUrl | 否 | string | web落地页地址 |
translation | 是 | string[] | 翻译结果数组 |
basic | 否 | - | 查询字典的结果 不一定有 |
+explains | 否 | string[] | 字典解释数组 |
语种检测
请求URL
/api/v1/translation/detect
请求方法
POST
Header
Content-Type application/json
body请求体
{
"appId":"app",
"requestId":"uuid",
"texts":[
{
"Text":"hello."
},
{
"Text":"今天天气真好. good."
}
]
}
参数说明
参数名 | 是否必选 | 类型 | 说明 |
---|---|---|---|
appId | 是 | string | app名 |
requestId | 是 | string | 请求随机UUID |
texts | 是 | list | 文本数组(支持批量文本检测) |
+Text | 是 | string | 要检测的文本 |
返回结果
{
"languages":[
{
"language":"en",
"score":1.0
},
{
"language":"zh-chs",
"score":0.86
}
]
}
返回字段说明
参数名 | 是否必选 | 类型 | 说明 |
---|---|---|---|
languages | 是 | list | 语种结果 |
+language | 是 | string | 语种代号 |
+score | 是 | float | 置信度 |