API 参考执行任务
创建任务运行
POST /tasks
创建任务运行
调用 `POST /tasks`，创建任务运行。
https://api.edgecron.com/v1/tasks
需要认证
每个请求都需要携带 `X-Key-ID`、`X-Timestamp` 和 `X-Signature`。签名为 `timestamp + "\n" + payload` 的 HMAC-SHA256 小写十六进制结果。
参数
该接口没有定义路径参数或查询参数。
请求体
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint_id | integer (int64) | 是 | 目标 Webhook 端点 ID。 |
payload | string | 否 | 待投递的 JSON payload。 |
run_at | integer (int64) | 否 | Unix 时间戳，0 表示立即执行。 |
{
"endpoint_id": 101,
"payload": {
"invoice_id": "inv_123",
"status": "paid"
},
"run_at": 1772534400
}响应
所有成功响应都使用 EdgeCron API 统一信封。
{
"code": 0,
"message": "success",
"request_id": "req_abc123",
"data": {
"id": 101,
"app_id": "app_123",
"schedule_id": 101,
"event_id": 101,
"endpoint_id": 101,
"task_type": "schedule",
"payload": {},
"status": "pending",
"run_at": 1772534400,
"created_at": "2026-07-01T12:00:00Z"
}
}结构
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
id | integer | 否 | 资源 ID。 |
app_id | string | 否 | 应用 ID。 |
schedule_id | integer | 否 | - |
event_id | integer | 否 | - |
endpoint_id | integer | 否 | - |
task_type | schedule / event / manual | 否 | 可选值：schedule, event, manual。 |
payload | object | 否 | 转发到目标端点的 JSON payload。 |
status | pending / running / success / failed / canceled | 否 | 可选值：pending, running, success, failed, canceled。 |
run_at | string (date-time) | 否 | - |
created_at | string (date-time) | 否 | 创建时间。 |