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	置信度