Detalhes do Ciclo de Vida da Tarefa
Use a referência a seguir para formatar suas solicitações e interpretar todas as respostas que a API do AI Scraper retorna durante o ciclo de vida de uma tarefa.
Parâmetros Comuns da Solicitação
| Parameter | Type | Required | Description |
|---|---|---|---|
actor | string | Yes | Identificador fixo que indica qual modelo você deseja executar. |
webhook | object | No | Objeto contendo configurações opcionais de webhook. |
webhook.url | string | No | Endpoint HTTPS que recebe o resultado quando a tarefa é concluída. |
input | object | Yes | Parâmetros específicos do ator, como prompt, modo ou país. |
Estrutura de Dados do Resultado
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | Yes | Status da tarefa: pending, running, success ou failed. |
message | string | No | Mensagem de erro se a tarefa falhar. |
task_result | object | No | Payload completo para o ator. Consulte a documentação do ator para detalhes em nível de campo. |
Payload de Envio via Webhook
Se você definir um webhook.url, o Scrapeless emite uma solicitação POST com a seguinte estrutura JSON:
| Parameter | Type | Required | Description |
|---|---|---|---|
task_id | string | Yes | Identificador da tarefa concluída. |
status | string | Yes | success ou failed. |
input | string | Yes | Parâmetros originais da tarefa serializados como JSON. |
task_result | object | No | Mesma estrutura que você receberia ao consultar o endpoint de resultado. |
Exemplo de Envio
curl --location '{webhook.url}' \
--header 'Content-Type: application/json' \
--data '{
"task_id": "",
"status": "",
"input": "",
"task_result": {}
}'Códigos de Status HTTP
| Status | Meaning |
|---|---|
200 | Sucesso. O resultado foi recuperado. |
201 | Tarefa criada com sucesso. |
202 | Tarefa ainda em execução—tente novamente em breve. |
400 | Solicitação inválida ou falha na execução. Verifique a mensagem de erro para obter detalhes. |
410 | Resultado da tarefa expirado. |
429 | Limite de taxa excedido. Reduza a frequência de solicitações ou aumente a capacidade. |