タスクライフサイクルの詳細

以下のリファレンスを使用して、リクエストの形式を整え、タスクのライフタイム中に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は次のJSON形式でPOSTリクエストを送信します：

パラメータ	型	必須	説明
`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