任务生命周期详解

参考以下内容来构建你的请求，并解读 AI Scraper API 在任务生命周期内返回的每一个响应。

通用请求参数

参数	类型	是否必填	说明
`actor`	string	是	用于指示要运行哪个模型的固定标识符。
`webhook`	object	否	包含可选 webhook 设置的对象。
`webhook.url`	string	否	任务完成后接收结果的 HTTPS 端点。
`input`	object	是	Actor 特定的参数，例如 prompt、mode 或 country。

结果数据结构

参数	类型	是否必填	说明
`status`	string	是	任务状态：`pending`、`running`、`success` 或 `failed`。
`message`	string	否	任务失败时的错误信息。
`task_result`	object	否	Actor 的完整载荷。字段级细节请参阅 actor 文档。

Webhook 推送载荷

如果你设置了 webhook.url，Scrapeless 会发起一个 POST 请求，其 JSON 结构如下：

参数	类型	是否必填	说明
`task_id`	string	是	已完成任务的标识符。
`status`	string	是	`success` 或 `failed`。
`input`	string	是	序列化为 JSON 的原始任务参数。
`task_result`	object	否	与轮询结果端点时收到的结构相同。

推送示例

curl --location '{webhook.url}' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "",
    "status": "",
    "input": "",
    "task_result": {}
  }'

HTTP 状态码

状态码	含义
`200`	成功。结果已成功获取。
`201`	任务创建成功。
`202`	任务仍在运行中——请稍后重试。
`400`	请求无效。请查看错误信息了解详情。
`410`	任务结果已过期。结果保留 12 小时。
`429`	超出速率限制。请降低请求频率或升级容量。

入门指南 ChatGPT