1. 回调
知眸开放平台
  • 部署文档
  • 接口错误码
  • 更新记录
  • 授权
    • 授权接口
      POST
  • 应用
    • 获取应用列表
      GET
  • 任务
    • 开启任务
      POST
    • 获取任务列表
      GET
    • 结束任务
      DELETE
    • 更新任务配置
      PUT
    • 上传任务图片
      POST
    • 获取指定应用AI视频
      POST
    • 关闭指定应用AI视频
      DELETE
  • 回调
    • Mqtt任务数据订阅
    • 消息回调接口
      POST
  • 流媒体
    • 获取视频流
      POST
    • 释放视频流
      DELETE
  • 与核心版接口改动说明
    • 核心版卸载
    • 授权模块
    • 应用模块
    • 任务模块
    • 回调
  1. 回调

消息回调接口

POST
责任人:zhoukk
开放平台运行任务过程中生成消息后调用回调接口推送消息数据给三方系统,三方系统接口接受到请求后需返回json格式 {code: 0} 数据,否则开放平台会重试推送3次。

请求参数

Authorization
在 Header 添加参数
Authorization
,其值为在 Bearer 之后拼接 Token
示例:
Authorization: Bearer ********************
Body 参数application/json必填

示例
{
    "event": "string",
    "task_id": "string",
    "zapk_id": "string",
    "device_id": "string",
    "business_id": "string",
    "timestamp": 0,
    "data": {
        "frame": {
            "id": 0,
            "width": 0,
            "height": 0,
            "enhance": 0,
            "image": "string"
        },
        "apps": [
            {
                "app_id": "string",
                "app_name": "string",
                "image": "string",
                "objects": [
                    {
                        "class_id": "string",
                        "name": "string",
                        "color": "string",
                        "x": 0,
                        "y": 0,
                        "track_id": "string",
                        "confidence": 0,
                        "attr": {
                            "name": "string",
                            "text": "string",
                            "box": {
                                "x": 0,
                                "y": 0,
                                "w": 0,
                                "h": 0
                            }
                        },
                        "description": "string"
                    }
                ],
                "scene_instances": [
                    {
                        "description": "string",
                        "x": 0,
                        "y": 0,
                        "objects": [
                            {
                                "class_id": "string",
                                "name": "string",
                                "color": "string",
                                "x": 0,
                                "y": 0,
                                "track_id": "string",
                                "confidence": 0,
                                "attr": {
                                    "name": "string",
                                    "text": "string",
                                    "box": {
                                        "x": 0,
                                        "y": 0,
                                        "w": 0,
                                        "h": 0
                                    }
                                }
                            }
                        ]
                    }
                ]
            }
        ],
        "dump": "string",
        "close_code": 0
    }
}

请求示例代码

Shell
JavaScript
Java
Swift
Go
PHP
Python
HTTP
C
C#
Objective-C
Ruby
OCaml
Dart
R
请求示例请求示例
Shell
JavaScript
Java
Swift
curl --location '' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
    "event": "string",
    "task_id": "string",
    "zapk_id": "string",
    "device_id": "string",
    "business_id": "string",
    "timestamp": 0,
    "data": {
        "frame": {
            "id": 0,
            "width": 0,
            "height": 0,
            "enhance": 0,
            "image": "string"
        },
        "apps": [
            {
                "app_id": "string",
                "app_name": "string",
                "image": "string",
                "objects": [
                    {
                        "class_id": "string",
                        "name": "string",
                        "color": "string",
                        "x": 0,
                        "y": 0,
                        "track_id": "string",
                        "confidence": 0,
                        "attr": {
                            "name": "string",
                            "text": "string",
                            "box": {
                                "x": 0,
                                "y": 0,
                                "w": 0,
                                "h": 0
                            }
                        },
                        "description": "string"
                    }
                ],
                "scene_instances": [
                    {
                        "description": "string",
                        "x": 0,
                        "y": 0,
                        "objects": [
                            {
                                "class_id": "string",
                                "name": "string",
                                "color": "string",
                                "x": 0,
                                "y": 0,
                                "track_id": "string",
                                "confidence": 0,
                                "attr": {
                                    "name": "string",
                                    "text": "string",
                                    "box": {
                                        "x": 0,
                                        "y": 0,
                                        "w": 0,
                                        "h": 0
                                    }
                                }
                            }
                        ]
                    }
                ]
            }
        ],
        "dump": "string",
        "close_code": 0
    }
}'

返回响应

🟢200成功
application/json
Bodyapplication/json

示例
{
    "code": 0
}
修改于 2026-07-22 06:37:58
上一页
Mqtt任务数据订阅
下一页
获取视频流
Built with