Detalhes do Ciclo de Vida da Tarefa

Use a referência a seguir para estruturar suas requisições e interpretar cada resposta que a API do AI Scraper retorna durante o ciclo de vida de uma tarefa.

Parâmetros Comuns de Requisição

Parâmetro	Tipo	Obrigatório	Descrição
`actor`	string	Sim	Identificador fixo que indica qual modelo você deseja executar.
`webhook`	object	Não	Objeto que contém configurações opcionais de webhook.
`webhook.url`	string	Não	Endpoint HTTPS que recebe o resultado quando a tarefa é concluída.
`input`	object	Sim	Parâmetros específicos do actor, como prompt, modo ou país.

Estrutura dos Dados de Resultado

Parâmetro	Tipo	Obrigatório	Descrição
`status`	string	Sim	Status da tarefa: `pending`, `running`, `success` ou `failed`.
`message`	string	Não	Mensagem de erro caso a tarefa falhe.
`task_result`	object	Não	Payload completo do actor. Consulte a documentação do actor para detalhes de cada campo.

Payload de Envio do Webhook

Se você definir uma webhook.url, o Scrapeless envia uma requisição POST com o seguinte formato JSON:

Parâmetro	Tipo	Obrigatório	Descrição
`task_id`	string	Sim	Identificador da tarefa concluída.
`status`	string	Sim	`success` ou `failed`.
`input`	string	Sim	Parâmetros originais da tarefa serializados como JSON.
`task_result`	object	Não	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	Significado
`200`	Sucesso. O resultado foi recuperado.
`201`	Tarefa criada com sucesso.
`202`	Tarefa ainda em execução—tente novamente em breve.
`400`	Requisição inválida. Verifique a mensagem de erro para detalhes.
`410`	Resultado da tarefa expirado. Os resultados permanecem disponíveis por 12 horas.
`429`	Limite de requisições excedido. Reduza a frequência de requisições ou aumente a capacidade.

Primeiros passos ChatGPT