回调

4.1 MQTT回调

1. event = start, event = stop, event = dummy_frame_start, event = dummy_frame_stop

字段名	旧版	新版	变更类型	变更说明
zapk_id	-	string、必选	新增字段	应用包ID,即旧版apps下app_id
device_id	-	string、可选	新增字段	设备ID, 即旧版的device
business_id	string、可选	string、可选	无变更	业务ID
event	string、可选	string、可选	无变更	事件
task_id	string、必选	string、必选	无变更	任务ID
timestamp	integer、必选	integer、必选	无变更	时间戳
app_id	string、必选	-	删除字段	字段已移除
device	string、可选	-	删除字段	字段已移除

2. 视频分析任务识别数据发布 event = frame

字段名	旧版	新版	变更类型	变更说明
zapk_id	-	string、必选	新增字段	应用包ID,即旧版apps下app_id
device_id	-	string、可选	新增字段	设备ID, 即旧版的device
event	string、必选	string、必选	无变更	事件
task_id	string、必选	string、必选	无变更	任务ID
business_id	string、可选	string、可选	无变更	业务ID
timestamp	integer、必选	integer、必选	无变更	时间戳
data	object、可选	object、可选	无变更	事件数据
app_id	string、必选	-	删除字段	字段已移除
device	string、可选	-	删除字段	字段已移除

2. data子级字段

字段名	旧版	新版	变更类型	变更说明
dump	-	string、可选	新增字段	任务校验码, 即旧版的task_dump
close_code	-	integer、可选	新增字段	任务结束码,即旧版的close_reason,1: 主动关闭,2: 视频流结束,3: 任务超时(视频任务补黑帧超时
apps	-	array、必选	新增字段	应用结果列表, 即旧版的rules
frame	object、可选	object、可选	数据结构变化	详见frame
task_dump	string、必选	-	删除字段	字段已移除
close_code	integer、可选	-	删除字段	字段已移除
rules	array、必选	-	删除字段	字段已移除

3. frame子级字段

字段名	旧版	新版	变更类型	变更说明
enhance	-	integer、必选	新增字段	图片增强参数
id	integer、必选	integer、必选	无变更	视频帧ID或图片ID
width	integer、必选	integer、必选	无变更	图片宽度
height	integer、必选	integer、必选	无变更	图片高度
flight	object、必选	-	删除字段	字段已移除

4. apps子级字段

字段名	旧版	新版	变更类型	变更说明
scene_instances	-	array、可选	新增字段	场景实例
app_id	-	string、必选	无变更	应用ID, 即旧版的rule_id
app_name	-	string、必选	无变更	应用名称, 即旧版的rule_name
image	string、可选	string、可选	值变更	base64->url
objects	array、可选	array、可选	数据结构变化	详见objects
app_id	string、必选	-	删除字段	字段已移除
app_name	string、必选	-	删除字段	字段已移除

5. objects子级字段

字段名	旧版	新版	变更类型	变更说明
attr	-	object、可选	新增字段	属性识别结果
description	-	string、可选	新增字段	目标描述
class_id	string、必选	string、必选	无变更	类别ID
name	string、必选	string、必选	无变更	类别名称
color	string、必选	string、必选	无变更	颜色
x	integer、必选	integer、必选	无变更	中心点X坐标
y	integer、必选	integer、必选	无变更	中心点Y坐标
track_id	integer、可选	integer、可选	无变更	跟踪ID
confidence	number、必选	number、必选	无变更	置信度
speed_px	integer、可选	-	删除字段	字段已移除
angle_px	integer、可选	-	删除字段	字段已移除
class_name	string、必选	-	删除字段	字段已移除
attr_name	string、可选	-	删除字段	字段已移除
attr_text	string、可选	-	删除字段	字段已移除
attr_image	string、可选	-	删除字段	字段已移除
attrs	array、可选	-	删除字段	字段已移除

4.2 消息回调 POST /

请求方式、请求路径两版一致。

1. 回调根字段

字段名	旧版	新版	变更类型	变更说明
zapk_id	-	string、必选	新增字段	应用包ID,即旧版apps下app_id
device_id	-	string、可选	新增字段	设备ID, 即旧版的device
event	string、必选	string、必选	无变更	start: 任务开始, stop: 任务关闭, message: 消息生成, dummy_frame_start: 补黑帧开始, dummy_frame_stop: 补黑帧结束
task_id	string、必选	string、必选	无变更	任务ID
business_id	string、可选	string、可选	无变更	业务ID
timestamp	integer、必选	integer、必选	无变更	时间戳
data	object、可选	object、可选	无变更	事件数据
app_id	string、必选	-	删除字段	字段已移除
device	string、可选	-	删除字段	字段已移除

2. data子级字段

字段名	旧版	新版	变更类型	变更说明
dump	-	string、可选	新增字段	任务校验码, 即旧版的task_dump
close_code	-	integer、可选	新增字段	任务结束码,即旧版的close_reason,1: 主动关闭,2: 视频流结束,3: 任务超时(视频任务补黑帧超时
apps	-	array、必选	新增字段	应用结果列表, 即旧版的rules
frame	object、可选	object、可选	数据结构变更	详见frame
task_dump	string、必选	-	删除字段	字段已移除
close_code	integer、可选	-	删除字段	字段已移除
rules	array、必选	-	删除字段	字段已移除

3. frame子级字段

字段名	旧版	新版	变更类型	变更说明
enhance	-	integer、必选	新增字段	图片增强参数
id	integer、必选	integer、必选	无变更	视频帧ID或图片ID
width	integer、必选	integer、必选	无变更	图片宽度
height	integer、必选	integer、必选	无变更	图片高度
flight	object、必选	-	删除字段	字段已移除

4. apps子级字段

字段名	旧版	新版	变更类型	变更说明
scene_instances	-	string、可选	新增字段	场景实例
app_id	-	string、必选	无变更	应用ID, 即旧版的rule_id
app_name	-	string、必选	无变更	应用名称, 即旧版的rule_name
image	string、可选	string、可选	值变更	base64->url
objects	array、可选	array、可选	数据结构变更	详见objects
app_id	string、必选	-	删除字段	字段已移除
app_name	string、必选	-	删除字段	字段已移除

5. objects子级字段

字段名	旧版	新版	变更类型	变更说明
attr	-	object、可选	新增字段	属性识别结果
description	-	string、可选	新增字段	目标描述
class_id	string、必选	string、必选	无变更	类别ID
name	string、必选	string、必选	无变更	类别名称
color	string、必选	string、必选	无变更	颜色
x	integer、必选	integer、必选	无变更	中心点X坐标
y	integer、必选	integer、必选	无变更	中心点Y坐标
track_id	integer、可选	integer、可选	无变更	跟踪ID
confidence	number、必选	number、必选	无变更	置信度
class_name	string、必选	-	删除字段	字段已移除
speed_px	integer、可选	-	删除字段	字段已移除
angle_px	integer、可选	-	删除字段	字段已移除
class_name	string、必选	-	删除字段	字段已移除

6. attr子级字段

字段名	旧版	新版	变更类型	变更说明
name	-	string、必选	新增字段	属性名称,即旧版attr_name
text	-	string、必选	新增字段	属性值,即旧版attr_box
box	-	object、必选	新增字段	框坐标

7. box子级字段

字段名	旧版	新版	变更类型	变更说明
x	-	integer、必选	新增字段	左上角X坐标
y	-	integer、必选	新增字段	左上角Y坐标
w	-	integer、必选	新增字段	宽度
h	-	integer、必选	新增字段	高度

修改于 2026-06-25 10:35:30