跳到主要内容
版本：4.0

创建巡检抓拍任务

POST /vid_inspect

本接口用于创建一个巡检抓拍任务。任务创建后，本接口立即返回。后续由媒体服务打开指定终端的实时视频流。流打开后，截图保存，然后关闭流。

  • 一请求一任务，多通道在同一任务内串行执行，不拆分打断。
  • 调度按 (priority DESC, reqTm ASC) 排队；不抢占已进入执行的任务（含任务内未跑完的通道）。全局并发达上限时进入等待队列；等待队列超限时返回 -23。
  • 当任务组创建，或任务通道执行状态发生变更时，或任务组整体结束时，媒体服务向消息队列投递一个任务事件（参见 巡检抓拍任务事件队列）。
  • 全通道结束后，除保留旧 vid-inspect-evt 外，还可选向 Kafka topic eeye-stm-inspect-evt 双发聚合结果（见 伊爱巡检完成聚合事件）。

请求​

POST https://wx.gratour.info:7200/v1/vid_inspect
Content-Type: application/json
X-Auth-Token: HrWwReOAQ9WdLnJQ1JYivA

{
  "simNo": "13320200317",
  "channels": [1,2,3,4],
  "priority": 0,
  "guid": 961916803414524930,
  "ai": true
}

请求实体属性​

属性数据类型必要说明
simNostringY终端识别号
channelsint[]Y所要执行抓拍的通道ID列表
priorityint抓拍优先级，取值 0–2。不提供时服务端默认 0。越界返回参数错误。
guidlong平台唯一 ID，用于结果匹配；可选。落库并在 eeye-stm-inspect-evt 原值回传。
aiboolean是否需要 AI 分析（带外字段）；可选。落库并在 eeye-stm-inspect-evt 原值回传。

应答​

{
  "data": [
    {
      "taskId": "AbctuB9sSJe8bbBzv-yr9g",
      "simNo": "13320200317",
      "channels": [1,2,3,4],
      "priority": 0,
      "guid": 961916803414524930,
      "ai": true,
      "reqTm": "2025-05-17 10:00:00",
      "successCount": 0,
      "states": [
        {
          "chan": 1,
          "state": 0
        },
        {
          "chan": 2,
          "state": 0
        },
        {
          "chan": 3,
          "state": 0
        }
      ]              
    }
  ],
  "errCode": 0,
  "message": "OK."
}

应答实体属性​

属性数据类型必要说明
errCodeintY错误码。 常见错误码：
  • -5: 任务登记超时（可能执行进程已经退出，调用者应保持隔一段时间重试）
  • -23: 等待队列已满（当前执行中任务达并发上限且排队数超限，调用者应保持隔一段时间重试）
  • -106: 未配置视频巡检功能
messagestringY错误信息
dataVidInspectTask[]返回的结果对象数组。元素为 VidInspectTask 类型
countint返回的记录数