任务生命周期详情

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

通用请求参数

参数	类型	必填	描述
`actor`	string	是	固定标识符，用于指定您要运行的模型。
`webhook`	object	否	包含可选 Webhook 设置的对象。
`webhook.url`	string	否	任务完成时接收结果的 HTTPS 端点。
`input`	object	是	特定于 Actor 的参数，例如提示词、模式或国家/地区。

结果数据结构

参数	类型	必填	描述
`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`	任务结果已过期。
`429`	超出速率限制。请降低请求频率或升级容量。

入门指南 ChatGPT