接口名称
文本翻译
接口地址
/api/platform/v1/translate/textTranslate
请求方式
POST
请求头
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
Content-Type | String | 是 | application/json;charset=UTF-8 |
请求参数
参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
sourceLanguageCode | String | 是 | 源语言代码，支持 'auto' 自动检测 |
targetLanguageCode | String | 是 | 目标语言代码 |
text | String | 是 | 待翻译的文本内容 |
语言代码说明
语言代码 | 说明 |
|---|---|
auto | 自动检测源语言 |
zh_CN | 简体中文 |
en_US | 英语 |
ja_JP | 日语 |
es | 西班牙语 |
de | 德语 |
请求示例
curl 'https://platform.etowertech.com/translate/textTranslate' \
-H 'Content-Type: application/json;charset=UTF-8' \
-d '{
"sourceLanguageCode": "auto",
"targetLanguageCode": "zh_CN",
"text": "DELIVERED"
}'
返回示例
{
"success": true,
"code": "0",
"data": "已妥投",
"errors": []
}
返回字段说明
字段 | 类型 | 说明 |
|---|---|---|
success | Boolean | 请求是否成功 |
code | String | 响应状态码，"0"表示成功 |
data | String | 翻译后的文本内容 |
errors | Array | 错误信息列表 |
使用场景
该接口主要用于*跟踪号运输信息的翻译功能*，具体应用场景：
1. *翻译跟踪详情*：将跟踪事件的描述翻译为用户选择的语言
2. *翻译更多信息标题*：翻译"更多信息"等界面文本
3. *翻译查询网址描述*：翻译查询网站的描述信息
批量翻译处理
当需要翻译多条文本时，前端采用*延时调用*策略，避免接口调用过于频繁：
接口特性
特性 | 说明 |
|---|---|
不需要登录 | notLogin: true，无需登录即可调用 |
无加载提示 | loading: false，调用时不显示加载动画 |
文本长度限制 | 建议单次翻译文本长度不超过 5000 字符 |
调用频率限制 | 批量翻译时建议间隔 1-2 秒调用 |
自动语言检测 | 支持 sourceLanguageCode: 'auto' 自动检测源语言 |