周期抽帧订阅 - Om Agent OpenAPI

请求参数

Header 参数

linker-sign

string

必需

Body 参数application/json

user_id

string

用户ID

必需

task_info

object

任务基础信息

必需

task_type

integer

任务类型

必需

不传就默认0 抽帧任务 1:资源任务

is_save

boolean

是否保存抽帧图片

可选

不传就默认false

默认值:

false

is_filter

boolean

是否过滤重复图片

可选

不传就默认false

默认值:

false

name

string

任务名称

必需

interval_issue

integer

频率值

必需

抽帧间隔频率，结合频率单位使用，默认5

interval_unit

integer

频率单位

必需

1表示秒（s），2表示分（min），3表示时（h），4表示毫秒（ms），默认秒

start_time

string

任务开始时间

必需

精确到秒，格式：YYYY-MM-DD HH:mm:ss

end_time

string

任务结束时间

必需

精确到秒，格式：YYYY-MM-DD HH:mm:ss

device_unicodes

array[string]

设备唯一编码列表

可选

当task_type为0时此值与channels二选一

channels

array [object {2}]

通道信息

可选

通道级别任务创建，与device_unicodes二选一，如果都存在，优先使用该字段

resource_urls

array[string]

资源列表

可选

当task_type为1时此值不能为空

description

string

任务描述

可选

frame_action

object

抽帧操作

必需

需要interval_issue>5s的时候，才能配置，frame_count和duration都传0 会关闭多次抽帧功能

task_timelines

array [object {2}]

任务时间区间

可选

默认全天

start_time

string

开始时间

必需

HH:mm:ss

end_time

string

结束时间

必需

HH:mm:ss

periodic

object

任务周期性

必需

period_type

integer

周期类型

必需

0按天，1按周，2按月

weekdays

array[integer]

按周循环

必需

例: [1, 3, 5]，period_type为1的时候有用

monthdays

array[integer]

按月循环

必需

例:[1, 15, 16, 20]，period_type为2的时候有用

ext_parameters

object

业务参数

可选

需要回调给业务方的参数

callback_info

object

回调信息

可选

url

string

回调地址

可选

http地址

type

string

回调类型

可选

http,mq，默认mq

示例

{
    "user_id": "68",
    "task_info": {
        "task_type": 28,
        "is_save": false,
        "is_filter": true,
        "name": "板语汐",
        "interval_issue": 9,
        "interval_unit": 54,
        "start_time": "2024-11-26 08:34:45",
        "end_time": "2025-04-06 05:15:03",
        "device_unicodes": [
            "39",
            "6",
            "71"
        ],
        "channels": [
            {
                "device_unicode": "64",
                "channel": "anim ipsum"
            },
            {
                "device_unicode": "86",
                "channel": "quis ullamco enim exercitation dolore"
            }
        ],
        "resource_urls": [
            "https://flawless-singing.com/"
        ],
        "description": "内生受构极从极算。近当定约就。",
        "frame_action": {
            "frame_count": 50,
            "duration": 76
        }
    },
    "task_timelines": [
        {
            "start_time": "2025-06-11 01:26:51",
            "end_time": "2025-02-18 04:11:07"
        }
    ],
    "periodic": {
        "period_type": 31,
        "weekdays": [
            2,
            91
        ],
        "monthdays": [
            68,
            31
        ]
    },
    "ext_parameters": {},
    "callback_info": {
        "url": "https://writhing-commodity.name/",
        "type": "reprehenderit dolore exercitation in"
    }
}

返回响应

🟢200成功

application/json

Body

code

string

必需

message

string

必需

data

object

必需

task_id

integer

必需

sub_task_ids

array[integer]

必需

sub_task_infos

array [object {3}]

必需

示例

{
    "code": "0",
    "message": "成功",
    "data": {
        "task_id": 1111
    }
}