翻译反馈API
更新时间:
提交用户对翻译效果的评价，支持「好」和「差」两种反馈。反馈数据用于翻译评测和模型迭代，统计结果可在对应项目的「数据统计」中查看。
POSThttps://translate.ilivedata.com/api/v2/translate/feedback
请求参数
请求头
以下请求头均为必需。
Header
值
说明
Content-Typeapplication/json; charset=UTF-8请求体格式
Acceptapplication/json; charset=UTF-8响应格式
X-AppId—
控制台「服务配置」中的项目编号
X-TimeStamp—
请求发起时的 UTC 时间，采用 W3C 格式。
格式示例：2026-09-30T02:30:00Z，实际请求需使用当前时间。
Authorization—
签名值，计算方式见下文「请求签名」
请求体
参数
类型
必需
说明
sourceString必需
原文本的语种（下称“源语言”）。此参数需设置为语言支持中列举的ISO 639-1标准的语言代码之一。
targetString必需
目标语言代码，取值见语言支持。
sourceTextString必需
原文本内容
targetTextString必需
翻译结果文本内容
feedbackInt必需
反馈结果：0 差，1 好。
userIdString可选
接收者 ID
noteString可选
备注信息
请求示例
{
"source": "en",
"target": "zh-CN",
"sourceText": "hello world",
"targetText": "世界你好",
"feedback": 1,
"userId": "119156631"
}
请求签名
使用项目的 secretKey 计算签名，将结果放入请求头 Authorization。签名不一致或项目无权限时返回 HTTP 401。
构造参数字符串
- 按参数名称排序。
- 按 RFC 3986 对参数名和值进行 URL 编码：字母、数字、
-、_、.、~ 保持不变，其他字符使用大写十六进制百分号编码；UTF-8 多字节字符逐字节编码。
- 使用
= 连接参数名和值（空值也保留 =），使用 & 连接各参数，得到 CanonicalizedQueryString。
使用表单 URL 编码库时，将编码结果中的 + 替换为 %20、* 替换为 %2A、%7E 替换为 ~。空格必须编码为 %20。
构造签名字符串
StringToSign = HTTPMethod + "\n" +
HostHeaderInLowercase + "\n" +
HTTPRequestURI + "\n" +
CanonicalizedQueryString
签名参数
值
HTTPMethodPOST
HostHeaderInLowercasetranslate.ilivedata.com
HTTPRequestURI/api/v2/translate/feedback
HTTPRequestURI 不包含查询参数。
计算 Authorization
以 secretKey 为密钥，使用 HMAC-SHA256 对 StringToSign 计算摘要，再将摘要进行 Base64 编码，作为 Authorization 请求头的值。
签名示例
准备项目编号 appId 和服务密钥 secretKey。
appId=***
secretKey=***
示例请求体：
{
"source": "en",
"target": "zh-CN",
"sourceText": "hello world",
"targetText": "世界你好",
"feedback": 1,
"userId": "119156631"
}
示例中的 CanonicalizedQueryString：
b3ad8e9d16439ccd5e91924d2516bf9592975003f69beff44e56cddf47bd3118
示例中的 StringToSign：
POST
translate.ilivedata.com
/api/v2/translate/feedback
b3ad8e9d16439ccd5e91924d2516bf9592975003f69beff44e56cddf47bd3118
X-AppId:1000
X-TimeStamp:2020-07-31T07:59:03Z
HMAC 计算得到的签名：
******
HTTP 响应
Content-Type: application/json;charset=UTF-8
响应字段
字段
类型
说明
errorCodeNumber错误码，0 表示成功
errorMessageString错误消息
响应示例
{
"errorCode": 0,
"errorMessage": "OK"
}
提交用户对翻译效果的评价，支持「好」和「差」两种反馈。反馈数据用于翻译评测和模型迭代，统计结果可在对应项目的「数据统计」中查看。
POST
https://translate.ilivedata.com/api/v2/translate/feedback请求参数
请求头
以下请求头均为必需。
| Header | 值 | 说明 |
|---|---|---|
Content-Type |
application/json; charset=UTF-8 |
请求体格式 |
Accept |
application/json; charset=UTF-8 |
响应格式 |
X-AppId |
— | 控制台「服务配置」中的项目编号 |
X-TimeStamp |
— | 请求发起时的 UTC 时间，采用 W3C 格式。 格式示例： 2026-09-30T02:30:00Z，实际请求需使用当前时间。 |
Authorization |
— | 签名值，计算方式见下文「请求签名」 |
请求体
| 参数 | 类型 | 必需 | 说明 |
|---|---|---|---|
source |
String |
必需 | 原文本的语种（下称“源语言”）。此参数需设置为语言支持中列举的ISO 639-1标准的语言代码之一。 |
target |
String |
必需 | 目标语言代码，取值见语言支持。 |
sourceText |
String |
必需 | 原文本内容 |
targetText |
String |
必需 | 翻译结果文本内容 |
feedback |
Int |
必需 | 反馈结果：0 差，1 好。 |
userId |
String |
可选 | 接收者 ID |
note |
String |
可选 | 备注信息 |
请求示例
{
"source": "en",
"target": "zh-CN",
"sourceText": "hello world",
"targetText": "世界你好",
"feedback": 1,
"userId": "119156631"
}
请求签名
使用项目的 secretKey 计算签名，将结果放入请求头 Authorization。签名不一致或项目无权限时返回 HTTP 401。
构造参数字符串
- 按参数名称排序。
- 按 RFC 3986 对参数名和值进行 URL 编码：字母、数字、
-、_、.、~保持不变，其他字符使用大写十六进制百分号编码；UTF-8 多字节字符逐字节编码。 - 使用
=连接参数名和值（空值也保留=），使用&连接各参数，得到CanonicalizedQueryString。
使用表单 URL 编码库时，将编码结果中的 + 替换为 %20、* 替换为 %2A、%7E 替换为 ~。空格必须编码为 %20。
构造签名字符串
StringToSign = HTTPMethod + "\n" +
HostHeaderInLowercase + "\n" +
HTTPRequestURI + "\n" +
CanonicalizedQueryString
| 签名参数 | 值 |
|---|---|
HTTPMethod |
POST |
HostHeaderInLowercase |
translate.ilivedata.com |
HTTPRequestURI |
/api/v2/translate/feedback |
HTTPRequestURI 不包含查询参数。
计算 Authorization
以 secretKey 为密钥，使用 HMAC-SHA256 对 StringToSign 计算摘要，再将摘要进行 Base64 编码，作为 Authorization 请求头的值。
签名示例
准备项目编号 appId 和服务密钥 secretKey。
appId=***
secretKey=***
示例请求体：
{
"source": "en",
"target": "zh-CN",
"sourceText": "hello world",
"targetText": "世界你好",
"feedback": 1,
"userId": "119156631"
}
示例中的 CanonicalizedQueryString：
b3ad8e9d16439ccd5e91924d2516bf9592975003f69beff44e56cddf47bd3118
示例中的 StringToSign：
POST
translate.ilivedata.com
/api/v2/translate/feedback
b3ad8e9d16439ccd5e91924d2516bf9592975003f69beff44e56cddf47bd3118
X-AppId:1000
X-TimeStamp:2020-07-31T07:59:03Z
HMAC 计算得到的签名：
******
HTTP 响应
Content-Type: application/json;charset=UTF-8
响应字段
| 字段 | 类型 | 说明 |
|---|---|---|
errorCode |
Number |
错误码，0 表示成功 |
errorMessage |
String |
错误消息 |
响应示例
{
"errorCode": 0,
"errorMessage": "OK"
}