功能说明
数据万象支持自定义设置回调 URL,在任务完成后,系统向该 URL 发送 HTTP POST 请求,请求体中包含通知内容。您可通过配置的回调地址及时了解任务处理的进展和状态,以便进行其他业务操作。
回调内容
任务完成后,系统会向您设置的回调地址发送回调内容,包含完整节点数据的内容展示如下:
<Response><EventName>TaskFinish</EventName><JobsDetail><Code>Success</Code><CreationTime>2023-07-18T16:14:36+0800</CreationTime><EndTime>2023-07-18T16:15:54+0800</EndTime><Input><BucketId>testpic-1253960454</BucketId><Object>test.mp3</Object><Region>ap-chongqing</Region></Input><JobId>s229aa658254311eeaf90856735d7e87d</JobId><Message>Success</Message><Operation><JobLevel>0</JobLevel><VocalScore><StandardObject>test.mp3</StandardObject><StandardUrl/></VocalScore><VocalScoreResult><PitchScore><SentenceScores><EndTime>200.811</EndTime><Score>100</Score><StartTime>0.572727</StartTime></SentenceScores><SentenceScores><EndTime>210.4</EndTime><Score>100</Score><StartTime>200.811</StartTime></SentenceScores><TotalScore>100</TotalScore></PitchScore><RhythemScore><SentenceScores><EndTime>200.811</EndTime><Score>100</Score><StartTime>0.572727</StartTime></SentenceScores><SentenceScores><EndTime>210.4</EndTime><Score>100</Score><StartTime>200.811</StartTime></SentenceScores><TotalScore>100</TotalScore></RhythemScore></VocalScoreResult></Operation><QueueId>p6617fd4048fa41faxxxxxxxxxxxx</QueueId><QueueType>Speeching</QueueType><StartTime>2023-07-18T16:14:37+0800</StartTime><State>Success</State><Tag>VocalScore</Tag></JobsDetail></Response>
具体的数据内容如下:
节点名称(关键字) | 父节点 | 描述 | 类型 |
Response | 无 | 保存结果的容器 | Container |
Container 节点 Response 的内容:
节点名称(关键字) | 父节点 | 描述 | 类型 |
EventName | Response | 固定值,为 TaskFinish | String |
JobsDetail | Response | Container 数组 |
实际案例
案例 1:通过任务接口触发的任务回调
<Response><EventName>TaskFinish</EventName><JobsDetail><Code>Success</Code><CreationTime>2023-07-18T16:14:36+0800</CreationTime><EndTime>2023-07-18T16:15:54+0800</EndTime><Input><BucketId>testpic-1253960454</BucketId><Object>test.mp3</Object><Region>ap-chongqing</Region></Input><JobId>s229aa658254311eeaf90856735d7e87d</JobId><Message>Success</Message><Operation><JobLevel>0</JobLevel><VocalScore><StandardObject>test.mp3</StandardObject><StandardUrl/></VocalScore><VocalScoreResult><PitchScore><SentenceScores><EndTime>200.811</EndTime><Score>100</Score><StartTime>0.572727</StartTime></SentenceScores><SentenceScores><EndTime>210.4</EndTime><Score>100</Score><StartTime>200.811</StartTime></SentenceScores><TotalScore>100</TotalScore></PitchScore><RhythemScore><SentenceScores><EndTime>200.811</EndTime><Score>100</Score><StartTime>0.572727</StartTime></SentenceScores><SentenceScores><EndTime>210.4</EndTime><Score>100</Score><StartTime>200.811</StartTime></SentenceScores><TotalScore>100</TotalScore></RhythemScore></VocalScoreResult></Operation><QueueId>p6617fd4048fa41faxxxxxxxxxxxx</QueueId><QueueType>Speeching</QueueType><StartTime>2023-07-18T16:14:37+0800</StartTime><State>Success</State><Tag>VocalScore</Tag></JobsDetail></Response>
案例 2:通过任务接口触发的任务回调, 格式为 JSON
{"EventName":"TaskFinish","JobsDetail":[{"Code":"Success","CreationTime":"2023-07-18T16:14:36+0800","EndTime":"2023-07-18T16:15:54+0800","Input":{"BucketId":"testpic-1253960454","Object":"test.mp3","Region":"ap-chongqing"},"JobId":"s229aa658254311eeaf90856735d7e87d","Message":"Success","Operation":{"JobLevel":"0","VocalScore":{"StandardObject":"test.mp3","StandardUrl":""},"VocalScoreResult":{"PitchScore":{"SentenceScores":[{"EndTime":"200.811","Score":"100","StartTime":"0.572727"},{"EndTime":"210.4","Score":"100","StartTime":"200.811"}],"TotalScore":"100"},"RhythemScore":{"SentenceScores":[{"EndTime":"200.811","Score":"100","StartTime":"0.572727"},{"EndTime":"210.4","Score":"100","StartTime":"200.811"}],"TotalScore":"100"}}},"QueueId":"p6617fd4048fa41faxxxxxxxxxxxx","QueueType":"Speeching","StartTime":"2023-07-18T16:14:37+0800","State":"Success","Tag":"VocalScore"}]}