文档项目--机器翻译-火山引擎

文档中心

立即注册

导航

文档项目

最近更新时间：2025.12.16 11:04:06首次发布时间：2025.12.16 11:04:06

使用指南

您可以在文档项目下的项目【设置】-【开发设置】中找到Webhooks。
alt

配置指南

新建配置

点击【+新建配置】按钮，可以创建webhooks。并填写【名称】，【通知URL】和选择【Webhook ID】
alt

管理配置

点击每一个webhook，可以进行编辑和删除。
alt

历史记录

点击webhooks历史记录按钮，可以查看hooks发送历史记录。
alt
alt

开发指南

通知类型

以下列出了几种通知类型及国际化翻译平台发送的标准数据格式。

创建文档任务

{
	"event": "doc.task.created",
  "projectId": {{projectId}},
  "operator": {{operator}},
  "operatorTime": 1642487264830,
  "operationType": 0,
	"taskId": {{taskID}},
  "taskState": 0  
}

文档任务完成

{
	"event": "doc.task.finished",
  "projectId": {{projectId}},
  "operator": {{operator}},
  "operatorTime": 1642487264830,
  "operationType": 0,
	"taskId": {{taskID}},
  "taskState": 3,
  "subtasks": [{
   	"subTaskId": {{subTaskId}},
    "subTaskState": 3,
    "subTaskSourcefileUrl": "",
    "subTaskTransfileUrl": ""
   }]
}

终止文档任务

{
	"event": "doc.task.terminated",
  "projectId": {{projectId}},
  "operator": {{operator}},
  "operatorTime": 1642487264830,
  "operationType": 0,
	"taskId": {{taskID}},
  "taskState": 3,
  "subtasks": [{
   	"subTaskId": {{subTaskId}},
    "subTaskState": 3,
    "subTaskSourcefileUrl": "",
    "subTaskTransfileUrl": ""
   }]
}

删除文档任务

{
	"event": "doc.task.deleted",
  "projectId": {{projectId}},
  "operator": {{operator}},
  "operatorTime": 1642487264830,
  "operationType": 0,
	"taskId": {{taskID}},
  "taskState": 0
}

数据发送方式说明

统一使用 POST 请求发送。

通知数据说明

参数	说明
event	Webhooks ID
projectId	项目Id
operator	操作人Id，译员端操作触发固定为「译员」
operatorTime	操作产生时间，精确至 ms
operationType	操作类型来源，0 - 管理端、1 - MT、2 - TM、3 - 导入、4 - 译员端、5 - OpenAPI
taskId	翻译任务Id
taskState	翻译任务状态 1: 待指派，2: 处理中，3: 完成，4：停止，5: 删除
subtasks	翻译任务子任务
subtasks.subTaskId	子任务Id
subtasks.subTaskState	子任务状态 1: 待指派，2: 处理中，3: 完成，4：停止，5: 删除
subtasks.subTaskSourcefileUrl	子任务源文案文件url
subtasks.subTaskTransfileUrl	子任务翻译文件