tencent cloud

Callback Information
Last updated:2026-01-12 18:52:35
Callback Information
Last updated: 2026-01-12 18:52:35

Feature Overview

Cloud Infinite supports custom configuration of callback URLs. After a task is completed, the system sends an HTTP POST request to this URL, with the notification content in the request body. You can use the callback URL to learn about the task processing progress and status in a timely manner for other business operations.

Callback Content

After task completion, the system will send callback content to your configured callback address. The following shows the complete content of the node data:
<Response>
<EventName>TaskFinish</EventName>
<JobsDetail>
<Code>Success</Code>
<CreationTime>2022-06-30T18:37:37+0800</CreationTime>
<EndTime>2022-06-30T18:39:08+0800</EndTime>
<Input>
<BucketId>test-123456789</BucketId>
<Object>input/demo.mp4</Object>
<Region>ap-chongqing</Region>
</Input>
<JobId>ja8de3b46f86011ec9452c1c27f56a659</JobId>
<Message/>
<Operation>
<DigitalWatermark>
<Message>123456789ab</Message>
<Type>Text</Type>
<Version>V1</Version>
</DigitalWatermark>
<MediaInfo>
<Format>
<Bitrate>2533.526000</Bitrate>
<Duration>215.638000</Duration>
<FormatLongName>QuickTime / MOV</FormatLongName>
<FormatName>mov,mp4,m4a,3gp,3g2,mj2</FormatName>
<NumProgram>0</NumProgram>
<NumStream>2</NumStream>
<Size>68290577</Size>
<StartTime>0.000000</StartTime>
</Format>
<Stream>
<Audio>
<Bitrate>256.050000</Bitrate>
<Channel>2</Channel>
<ChannelLayout>stereo</ChannelLayout>
<CodecLongName>AAC (Advanced Audio Coding)</CodecLongName>
<CodecName>aac</CodecName>
<CodecTag>0x6134706d</CodecTag>
<CodecTagString>mp4a</CodecTagString>
<CodecTimeBase>1/48000</CodecTimeBase>
<Duration>215.637000</Duration>
<Index>1</Index>
<Language>eng</Language>
<SampleFmt>fltp</SampleFmt>
<SampleRate>48000</SampleRate>
<StartTime>0.000000</StartTime>
<Timebase>1/48000</Timebase>
</Audio>
<Subtitle/>
<Video>
<AvgFps>24.000000</AvgFps>
<Bitrate>2272.528000</Bitrate>
<CodecLongName>H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10</CodecLongName>
<CodecName>h264</CodecName>
<CodecTag>0x31637661</CodecTag>
<CodecTagString>avc1</CodecTagString>
<CodecTimeBase>1/12288</CodecTimeBase>
<ColorPrimaries>unknown</ColorPrimaries>
<ColorRange>unknown</ColorRange>
<ColorTransfer>unknown</ColorTransfer>
<Duration>215.583333</Duration>
<Fps>24.000000</Fps>
<HasBFrame>2</HasBFrame>
<Height>1080</Height>
<Index>0</Index>
<Language>und</Language>
<Level>40</Level>
<NumFrames>5174</NumFrames>
<PixFormat>yuv420p</PixFormat>
<Profile>High</Profile>
<RefFrames>1</RefFrames>
<Rotation>0.000000</Rotation>
<StartTime>0.000000</StartTime>
<Timebase>1/12288</Timebase>
<Width>1920</Width>
</Video>
</Stream>
</MediaInfo>
<MediaResult>
<OutputFile>
<Bucket>test-123456789</Bucket>
<Md5Info>
<Md5>043221daee3f4e15ff13f42329f15eb1</Md5>
<ObjectName>output/digital.mp4</ObjectName>
</Md5Info>
<ObjectName>output/digital.mp4</ObjectName>
<ObjectPrefix/>
<Region>ap-chongqing</Region>
</OutputFile>
</MediaResult>
<Output>
<Bucket>test-123456789</Bucket>
<Object>output/digital.mp4</Object>
<Region>ap-chongqing</Region>
</Output>
<UserData>This is my DigitalWatermark job.</UserData>
<JobLevel>0</JobLevel>
</Operation>
<QueueId>p2242ab62c7c94486915508540933a2c6</QueueId>
<StartTime>2022-06-30T18:37:38+0800</StartTime>
<State>Success</State>
<SubTag>DigitalWatermark</SubTag>
<Tag>DigitalWatermark</Tag>
</JobsDetail>
</Response>
The data content is as follows:
Node Name (Keyword)
Parent Node
Description
Type
Response
None
Container for saving results
Container
The content of container node Response:
Node Name (Keyword)
Parent Node
Description
Type
EventName
Response
The value is fixed as TaskFinish
String
JobsDetail
Response
Same as Response.JobsDetail in the submit digital watermarking task API
Container array
If the task is triggered by a workflow, Response.JobsDetail.Input will also include a CosHeaders node, which is of type Container array.
The content of container node CosHeaders:
Node Name (Keyword)
Parent Node
Description
Type
Key
Response.JobsDetail.Input.CosHeaders
Name of custom Header
String
Value
Response.JobsDetail.Input.CosHeaders
Value of custom Header
String
If the task is triggered by a workflow, Response.JobsDetail will also include a Workflow node, which is of type Container.
The content of container node Workflow:
Node Name (Keyword)
Parent Node
Description
Type
RunId
Response.Workflow
Workflow instance ID
String
WorkflowId
Response.Workflow
Workflow ID
String
WorkflowName
Response.Workflow
Workflow name
String
Name
Response.Workflow
Workflow node name
String

Practical Example

Case 1: Task Callback Triggered by Task API

<Response>
<EventName>TaskFinish</EventName>
<JobsDetail>
<Code>Success</Code>
<CreationTime>2022-06-30T18:37:37+0800</CreationTime>
<EndTime>2022-06-30T18:39:08+0800</EndTime>
<Input>
<BucketId>test-123456789</BucketId>
<Object>input/demo.mp4</Object>
<Region>ap-chongqing</Region>
</Input>
<JobId>ja8de3b46f86011ec9452c1c27f56a659</JobId>
<Message/>
<Operation>
<DigitalWatermark>
<Message>123456789ab</Message>
<Type>Text</Type>
<Version>V1</Version>
</DigitalWatermark>
<MediaInfo>
<Format>
<Bitrate>2533.526000</Bitrate>
<Duration>215.638000</Duration>
<FormatLongName>QuickTime / MOV</FormatLongName>
<FormatName>mov,mp4,m4a,3gp,3g2,mj2</FormatName>
<NumProgram>0</NumProgram>
<NumStream>2</NumStream>
<Size>68290577</Size>
<StartTime>0.000000</StartTime>
</Format>
<Stream>
<Audio>
<Bitrate>256.050000</Bitrate>
<Channel>2</Channel>
<ChannelLayout>stereo</ChannelLayout>
<CodecLongName>AAC (Advanced Audio Coding)</CodecLongName>
<CodecName>aac</CodecName>
<CodecTag>0x6134706d</CodecTag>
<CodecTagString>mp4a</CodecTagString>
<CodecTimeBase>1/48000</CodecTimeBase>
<Duration>215.637000</Duration>
<Index>1</Index>
<Language>eng</Language>
<SampleFmt>fltp</SampleFmt>
<SampleRate>48000</SampleRate>
<StartTime>0.000000</StartTime>
<Timebase>1/48000</Timebase>
</Audio>
<Subtitle/>
<Video>
<AvgFps>24.000000</AvgFps>
<Bitrate>2272.528000</Bitrate>
<CodecLongName>H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10</CodecLongName>
<CodecName>h264</CodecName>
<CodecTag>0x31637661</CodecTag>
<CodecTagString>avc1</CodecTagString>
<CodecTimeBase>1/12288</CodecTimeBase>
<ColorPrimaries>unknown</ColorPrimaries>
<ColorRange>unknown</ColorRange>
<ColorTransfer>unknown</ColorTransfer>
<Duration>215.583333</Duration>
<Fps>24.000000</Fps>
<HasBFrame>2</HasBFrame>
<Height>1080</Height>
<Index>0</Index>
<Language>und</Language>
<Level>40</Level>
<NumFrames>5174</NumFrames>
<PixFormat>yuv420p</PixFormat>
<Profile>High</Profile>
<RefFrames>1</RefFrames>
<Rotation>0.000000</Rotation>
<StartTime>0.000000</StartTime>
<Timebase>1/12288</Timebase>
<Width>1920</Width>
</Video>
</Stream>
</MediaInfo>
<MediaResult>
<OutputFile>
<Bucket>test-123456789</Bucket>
<Md5Info>
<Md5>043221daee3f4e15ff13f42329f15eb1</Md5>
<ObjectName>output/digital.mp4</ObjectName>
</Md5Info>
<ObjectName>output/digital.mp4</ObjectName>
<ObjectPrefix/>
<Region>ap-chongqing</Region>
</OutputFile>
</MediaResult>
<Output>
<Bucket>test-123456789</Bucket>
<Object>output/digital.mp4</Object>
<Region>ap-chongqing</Region>
</Output>
<UserData>This is my DigitalWatermark job.</UserData>
<JobLevel>0</JobLevel>
</Operation>
<QueueId>p2242ab62c7c94486915508540933a2c6</QueueId>
<StartTime>2022-06-30T18:37:38+0800</StartTime>
<State>Success</State>
<SubTag>DigitalWatermark</SubTag>
<Tag>DigitalWatermark</Tag>
</JobsDetail>
</Response>

Case 2: Task Callback Triggered by Task API in JSON Format

{
"EventName": "TaskFinish",
"JobsDetail": [{
"Code": "Success",
"CreationTime": "2022-06-30T18:37:37+0800",
"EndTime": "2022-06-30T18:39:08+0800",
"Input": {
"BucketId": "test-123456789",
"Object": "input/demo.mp4",
"Region": "ap-chongqing"
},
"JobId": "ja8de3b46f86011ec9452c1c27f56a659",
"Operation": {
"DigitalWatermark": {
"Message": "123456789ab",
"Type": "Text",
"Version": "V1"
},
"MediaInfo": {
"Format": {
"Bitrate": "2533.526000",
"Duration": "215.638000",
"FormatLongName": "QuickTime / MOV",
"FormatName": "mov,mp4,m4a,3gp,3g2,mj2",
"NumProgram": "0",
"NumStream": "2",
"Size": "68290577",
"StartTime": "0.000000"
},
"Stream": {
"Audio": [{
"Bitrate": "256.050000",
"Channel": "2",
"ChannelLayout": "stereo",
"CodecLongName": "AAC (Advanced Audio Coding)",
"CodecName": "aac",
"CodecTag": "0x6134706d",
"CodecTagString": "mp4a",
"CodecTimeBase": "1/48000",
"Duration": "215.637000",
"Index": "1",
"Language": "eng",
"SampleFmt": "fltp",
"SampleRate": "48000",
"StartTime": "0.000000",
"Timebase": "1/48000"
}],
"Video": [{
"AvgFps": "24.000000",
"Bitrate": "2272.528000",
"CodecLongName": "H.264 / AVC / MPEG-4 AVC / MPEG-4 part 10",
"CodecName": "h264",
"CodecTag": "0x31637661",
"CodecTagString": "avc1",
"CodecTimeBase": "1/12288",
"ColorPrimaries": "unknown",
"ColorRange": "unknown",
"ColorTransfer": "unknown",
"Duration": "215.583333",
"Fps": "24.000000",
"HasBFrame": "2",
"Height": "1080",
"Index": "0",
"Language": "und",
"Level": "40",
"NumFrames": "5174",
"PixFormat": "yuv420p",
"Profile": "High",
"RefFrames": "1",
"Rotation": "0.000000",
"StartTime": "0.000000",
"Timebase": "1/12288",
"Width": "1920"
}]
}
},
"MediaResult": {
"OutputFile": {
"Bucket": "test-123456789",
"Md5Info": [{
"Md5": "043221daee3f4e15ff13f42329f15eb1",
"ObjectName": "output/digital.mp4"
}],
"ObjectName": ["output/digital.mp4"],
"Region": "ap-chongqing"
}
},
"Output": {
"Bucket": "test-123456789",
"Object": "output/digital.mp4",
"Region": "ap-chongqing"
},
"UserData": "This is my DigitalWatermark job.",
"JobLevel": 0
},
"QueueId": "p2242ab62c7c94486915508540933a2c6",
"StartTime": "2022-06-30T18:37:38+0800",
"State": "Success",
"SubTag": "DigitalWatermark",
"Tag": "DigitalWatermark"
}]
}


Was this page helpful?
You can also Contact Sales or Submit a Ticket for help.
Yes
No

Feedback