创建巡检抓拍任务

POST /strm/vid-inspect

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

当任务组创建，或任务通道执行状态发生变更时，或任务组整体结束时，媒体服务向消息队列投递一个任务事件（参见 巡检抓拍任务事件队列）。

请求

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

{
  "simNo": "13320200317",
  "channels": [1,2,3,4]
}

请求实体属性

属性	数据类型	必要	说明
simNo	string	Y	终端识别号
channels	int[]	Y	所要执行抓拍的通道ID列表

应答

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

应答实体属性

属性	数据类型	必要	说明
errCode	int	Y	错误码。
message	string	Y	错误信息
data	VidInspectTask[]		返回的结果对象数组。元素为 VidInspectTask 类型
count	int		返回的记录数