发送延时请求,如果任务不存在,则会自动创建,但是自动创建的需要填写param

请求参数

Header 参数

Ithings-Project-Id

string

可选

默认值:

Ithings-Token

string

可选

默认值:

app-code

string

可选

默认值:

device-id

string

可选

用户正在使用的设备ID(小程序,ios,安卓的设备ID)

Body 参数application/json

groupCode

string

组需要提前创建好

必需

code

string

任务code

必需

option

object (TimedTaskOption)

可选

priority

integer <int64>

可选

优先级: 6:critical 最高优先级 3: default 普通优先级 1:low 低优先级以下两个参数优先使用ProcessIn

processIn

integer <int64>

多久之后发秒数

可选

processAt

integer <int64>

可选

固定时间发秒时间戳

timeout

integer <int64>

可选

超时时间优先使用秒数

deadline

integer <int64>

可选

截止时间秒时间戳

taskID

string

可选

指定运行的taskID

paramQueue

object (TimedTaskParamQueue)

可选

topic

string

必需

payload

string

必需

paramSql

object (TimedTaskParamSql)

可选

sql

string

必需

paramScript

object (TimedTaskParamScript)

可选

param

object

必需

execContent

string

必需

填写脚本内容,如果不填,则会使用数据库中第一次初始化的参数

示例

{
  "groupCode": "string",
  "code": "string",
  "option": {
    "priority": 0,
    "processIn": 0,
    "processAt": 0,
    "timeout": 0,
    "deadline": 0,
    "taskID": "string"
  },
  "paramQueue": {
    "topic": "string",
    "payload": "string"
  },
  "paramSql": {
    "sql": "string"
  },
  "paramScript": {
    "param": {},
    "execContent": "string"
  }
}

示例代码

Shell

JavaScript

Java

Swift

Go

PHP

Python

HTTP

C

C#

Objective-C

Ruby

OCaml

Dart

R

curl --location --request POST '/api/v1/system/job/task/send' \
--header 'Ithings-Project-Id: {{Ithings-Project-Id}}' \
--header 'Ithings-Token: {{iThings-token}}' \
--header 'app-code: {{appCode}}' \
--header 'device-id;' \
--header 'Content-Type: application/json' \
--data-raw ''

返回响应

🟢200成功

application/json

A successful response.

Body

code

integer

返回code

可选

默认值:

200

msg

string

返回的消息

可选

data

object (TimedTaskWithTaskID)

可选

taskID

string

运行的taskID

必需

示例

{
  "code": "200",
  "msg": "string",
  "data": {
    "taskID": "string"
  }
}