Webhooks 是处理 HTTP POST 请求的任意 URL,允许通知第三方系统有关指定事件。
Phrase 监控 webhook 回调是否成功接收。如果 webhook 接收失败 3000 次,则会被停用,并向账户的管理员发送通知,失败情况会在 页面上的特定 webhook 上记录。重试机制最多可重试 10 次,重试之间的间隔计算最大值为 30 分钟。
可以通过选择单个 webhook 来禁用/启用 webhook、显示历史记录、进行测试或从 webhook 页面删除。 功能提供过去 14 天的调用概述,失败的 webhook 可以重放。
可以为以下事件选择 Webhook:
-
工作状态已更改
-
工作已创建
-
工作已分配
-
工作截止日期已更改
-
工作源已更新
-
工作目标已更新(指的是 操作在 工作 上)
-
连续工作已更新
-
项目已创建
-
项目状态已更改
-
项目截止日期已更改
-
项目模板已创建
-
项目模板已更改
-
项目模板已删除
-
共享项目已分配
-
项目元数据已更新
-
预翻译完成
-
分析已创建
-
工作已删除
-
项目已删除
-
工作已导出
-
工作未导出
-
Language AI 导入完成
-
Language AI 翻译完成
要配置 Webhooks,请按照以下步骤操作:
一个名为 RequestBin 的网站将提供一个 URL,用于创建 webhook。
下次在账户中更改工作状态或创建工作时,URL 将从系统接收适当的响应。实际使用可能更复杂,接收响应应视为连接应用程序执行某些操作的信号。
事件
工作状态更改、工作分配、工作创建以及工作截止日期更改的示例。
工作状态已更改
{
"jobParts": [
{
"id": 9,
"uid": "ipmdz5p0sagqcOYaijTZU2",
"internalId": "4",
"task": "SEfSaenvqFgctE1I0_dc1",
"fileName": "en.txt",
"targetLang": "af",
"workflowLevel": 1,
"status": "NEW",
"wordsCount": 2,
"beginIndex": 0,
"endIndex": 1,
"isParentJobSplit": false,
"dateDue": null,
"dateCreated": "2016-11-02T17:06:54Z",
"project": {
"id": 2,
"uid": "4RvyVbwX00KerkomA7kpT9",
"lastWorkflowLevel": 1
},
"assignedTo": [
{
"vendor": {
"id": 1,
"name": "Abc",
"vendorToken": "4-ifos0-CAqPo"
}
},
{
"linguist": {
"id": 3,
"firstName": "Admin",
"lastName": "Admin",
"userName": "admin",
"email": "admin@example.com",
"role": "ADMIN",
"timezone": "Europe/London",
"active": true,
"deleted": false,
"terminologist": false,
"dateCreated": "2016-10-11T07:43:22Z"
}
}
]
}
],
"event": "JOB_STATUS_CHANGED"
}
工作分配
{
"jobParts": [
{
"id": 9,
"uid": "ipmdz5p0sagqcOYaijTZU2",
"internalId": "4",
"task": "SEfSaenvqFgctE1I0_dc1",
"fileName": "en.txt",
"targetLang": "af",
"workflowLevel": 1,
"status": "NEW",
"wordsCount": 2,
"beginIndex": 0,
"endIndex": 1,
"isParentJobSplit": false,
"dateDue": null,
"dateCreated": "2016-11-02T17:06:54Z",
"project": {
"id": 2
"uid": "4RvyVbwX00KerkomA7kpT9",
"lastWorkflowLevel": 1
},
"assignedTo": [
{
"vendor": {
"id": 1,
"name": "Abc",
"vendorToken": "4-ifos0-CAqPo"
}
},
{
"linguist": {
"id": 3,
"firstName": "Admin",
"lastName": "Admin",
"userName": "admin",
"email": "admin@example.com",
"role": "ADMIN",
"timezone": "Europe/London",
"active": true,
"deleted": false,
"terminologist": false,
"dateCreated": "2016-10-11T07:43:22Z"
}
}
]
}
],
"event": "JOB_ASSIGNED"
}
工作创建
{
"jobParts": [
{
"id": 9,
"uid": "ipmdz5p0sagqcOYaijTZU2",
"internalId": "4",
"task": "SEfSaenvqFgctE1I0_dc1",
"fileName": "en.txt",
"targetLang": "af",
"workflowLevel": 1,
"status": "NEW",
"wordsCount": 2,
"beginIndex": 0,
"endIndex": 1,
"isParentJobSplit": false,
"dateDue": null,
"dateCreated": "2016-11-02T17:06:54Z",
"project": {
"id": 2,
"uid": "4RvyVbwX00KerkomA7kpT9",
"lastWorkflowLevel": 1
},
"assignedTo": [
{
"vendor": {
"id": 1,
"name": "Abc",
"vendorToken": "4-ifos0-CAqPo"
}
},
{
"linguist": {
"id": 3,
"firstName": "Admin",
"lastName": "Admin",
"userName": "admin",
"email": "admin@example.com",
"role": "ADMIN",
"timezone": "Europe/London",
"active": true,
"deleted": false,
"terminologist": false,
"dateCreated": "2016-10-11T07:43:22Z"
}
}
]
}
],
"event": "JOB_CREATED"
}
工作截止日期已更改
{
"jobParts": [
{
"id": 127865777,
"uid": "ElTXvXnNIHEN2xgL5sU2L2",
"internalId": "1",
"task": "LvkAHilgobApeoVm_dc4",
"fileName": "EU White Paper Edited.doc",
"targetLang": "de",
"workflowLevel": 1,
"status": "NEW",
"wordsCount": 204,
"beginIndex": 0,
"endIndex": 16,
"isParentJobSplit": false,
"dateDue": "2018-09-11T22:00:00Z",
"dateCreated": "2018-09-10T06:25:41Z",
"project": {
"id": 12277756,
"uid": "4RvyVbwX00KerkomA7kpT9
"lastWorkflowLevel": 1
},
"assignedTo": []
}
],
"event": "JOB_DUE_DATE_CHANGED"
}