Detalhes do Ciclo de Vida da Tarefa

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

Parâmetros Comuns de Solicitaçã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 contendo 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 ator, como prompt, modo ou país.

Estrutura de Dados do 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 se a tarefa falhar.
`task_result`	object	Não	Payload completo para o ator. Consulte a documentação do ator para detalhes em nível de campo.

Payload de Envio do Webhook

Se você definir um webhook.url, o Scrapeless enviará uma solicitação POST com a seguinte estrutura 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`	Solicitação inválida. 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.

Primeiros passos ChatGPT