查看源

接口名称

文本翻译

接口地址

/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' 自动检测源语言