📢 Release 1.1.1(2026-09-29)现已推出
Arcadia

创建

POST
/cron/v1/create

根据项目功能设计,开放接口目前只允许创建用户任务。

授权

Token
headerapi-token<token>

32位令牌,在控制面板《个人设置 - 令牌管理》页面获取

请求主体

application/json
  1. body

创建定时任务请求体(name、cron、shell 必填)

id?integer

唯一标识

name*string

任务名称

type?CronTaskType

任务类型,当前固定分为 user 和 system

值于"user""system"
cron*string

定时规则(5位或6位的定时表达式)

shell*string

执行的命令

active?BinaryStatus

状态,1 启用、0 禁用

值于01
config?string

高级配置(值为 JSON 序列化后的字符串,结构见 CronTaskConfig)

tags?string

任务标签

last_runtime?|

最后一次运行的时间

格式date-time
last_run_use?|

最后一次运行的时长(单位秒,精确到小数点后3位)

sort?integer

在分页中的位置序号(正整数),默认按照先后顺序递增

create_time?string

任务创建时间

格式date-time
remark?string

备注

bind?string

任务关联的内部标识(仅系统任务返回)

error_notify?integer

任务执行失败时是否自动推送通知(1=启用,0=禁用)

默认1
is_running?boolean

当前运行状态(任务是否正在运行)

响应主体

返回创建后的任务完整信息

application/json
  1. response

定时任务完整记录(响应数据)

id*integer

唯一标识

name*string

任务名称

type*CronTaskType

任务类型,当前固定分为 user 和 system

值于"user""system"
cron*string

定时规则(5位或6位的定时表达式)

shell*string

执行的命令

active*BinaryStatus

状态,1 启用、0 禁用

值于01
config*string

高级配置(值为 JSON 序列化后的字符串,结构见 CronTaskConfig)

tags*string

任务标签

last_runtime*|

最后一次运行的时间

格式date-time
last_run_use*|

最后一次运行的时长(单位秒,精确到小数点后3位)

sort*integer

在分页中的位置序号(正整数),默认按照先后顺序递增

create_time*string

任务创建时间

格式date-time
remark*string

备注

bind*string

任务关联的内部标识(仅系统任务返回)

error_notify*integer

任务执行失败时是否自动推送通知(1=启用,0=禁用)

默认1
is_running*boolean

当前运行状态(任务是否正在运行)

error_alert*string

运行失败告警关联的通知渠道 ID(逗号分隔),内部业务字段

curl -X POST "https://example.com/cron/v1/create" \  -H "Content-Type: application/json" \  -d '{}'
{  "id": 0,  "name": "string",  "type": "user",  "cron": "string",  "shell": "string",  "active": 0,  "config": "string",  "tags": "string",  "last_runtime": "2019-08-24T14:15:22Z",  "last_run_use": 0,  "sort": 0,  "create_time": "2019-08-24T14:15:22Z",  "remark": "string",  "bind": "string",  "error_notify": 1,  "is_running": true,  "error_alert": "string"}