API 参考调度触发
更新定时计划
PATCH /schedules/{id}
更新定时计划
调用 `PATCH /schedules/{id}`，更新定时计划。
https://api.edgecron.com/v1/schedules/{id}
需要认证
每个请求都需要携带 `X-Key-ID`、`X-Timestamp` 和 `X-Signature`。签名为 `timestamp + "\n" + payload` 的 HMAC-SHA256 小写十六进制结果。
参数
| 参数 | 位置 | 类型 | 必填 | 说明 |
|---|---|---|---|---|
id | path | integer | 是 | 资源 ID。 |
请求体
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
name | string | 否 | - |
cron_expr | string | 否 | - |
timezone | string | 否 | - |
payload | string | 否 | 转发到目标端点的 JSON payload。 |
endpoint_ids | integer (int64)[] | 否 | - |
{
"name": "billing-webhook",
"cron_expr": "*/5 * * * *",
"timezone": "Asia/Shanghai",
"payload": {
"invoice_id": "inv_123",
"status": "paid"
},
"endpoint_ids": [
1
]
}响应
所有成功响应都使用 EdgeCron API 统一信封。
{
"code": 0,
"message": "success",
"request_id": "req_abc123",
"data": {
"id": 101,
"app_id": "app_123",
"name": "billing-webhook",
"cron_expr": "*/5 * * * *",
"timezone": "Asia/Shanghai",
"payload": {},
"status": "active",
"next_run_at": "2026-07-01T12:00:00Z",
"created_at": "2026-07-01T12:00:00Z",
"updated_at": "2026-07-01T12:00:00Z",
"endpoint_ids": [
1
],
"endpoint_names": {}
}
}结构
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | integer | 否 | 资源 ID。 |
app_id | string | 否 | 应用 ID。 |
name | string | 否 | - |
cron_expr | string | 否 | 示例：*/5 * * * *。 |
timezone | string | 否 | 示例：Asia/Shanghai。 |
payload | object | 否 | 转发到目标端点的 JSON payload。 |
status | active / paused / deleted | 否 | 可选值：active, paused, deleted。 |
next_run_at | string (date-time) | 否 | - |
created_at | string (date-time) | 否 | 创建时间。 |
updated_at | string (date-time) | 否 | 最后更新时间。 |
endpoint_ids | integer[] | 否 | 目标端点 ID 列表。为空表示全部启用端点。 |
endpoint_names | Record string to string | 否 | 端点 ID 到名称的展示映射。 |