运行已保存的任务模板

方法： POST

端点： /api/v1/task/run

使用 Content-Type: application/json 发送请求体。

在线试用

POST/api/v1/task/runStart saved task run

api-keyRequired

Stored only in this browser tab. Sent only to https://openapi.coreclaw.com.

BodyRequiredapplication/json

FieldTypeRequiredDescription

task_slugstringyesUnique saved task identifier.

callback_urlstringyesWebhook URL for async completion callbacks.

Request body (JSON)

当您已经有一个已保存的 Task 模板，并且希望基于该模板创建一次新的运行时，使用这个接口。

task_slug 是 任务 ID——创建并保存 Task 模板时生成的唯一标识符。Task 是可复用的配置，将 Worker 与预设参数打包在一起。

重要提示：请勿将 run_slug（运行记录 ID）或 scraper_slug（Worker ID）传入此字段。每种 slug 类型用途不同，不可互换。

{
    "task_slug": "YOUR_TASK_SLUG",
    "callback_url": "https://your-callback.example.com/webhook"
}

参数	示例值	类型	必填	说明
task_slug	YOUR_TASK_SLUG	String	是	任务 ID——已保存的 Task 模板的唯一标识符
callback_url	https://your-callback.example.com/webhook	String	是	用于接收 Task 运行结果的回调地址

{
    "code": 0,
    "message": "success",
    "data": {
        "run_slug": "01KSFDS8XWTJME33C08XMCR6B9"
    }
}

callback_url 为必填项。缺失时会返回 400 Bad Request。
请勿将 run_slug（运行记录 ID）或 scraper_slug（Worker ID）传入 task_slug 字段——每种 slug 类型不同，不可互换。

业务层错误可能返回如下结构化 JSON：

{
    "code": 60001,
    "message": "任务不存在",
    "data": null
}