Detalles del Ciclo de Vida de la Tarea

Utilice la siguiente referencia para estructurar sus solicitudes e interpretar cada respuesta que devuelve la API de AI Scraper durante la vigencia de una tarea.

Parámetros Comunes de Solicitud

Parámetro	Tipo	Requerido	Descripción
`actor`	string	Sí	Identificador fijo que indica qué modelo desea ejecutar.
`webhook`	object	No	Objeto que contiene configuraciones opcionales de webhook.
`webhook.url`	string	No	Endpoint HTTPS que recibe el resultado cuando la tarea finaliza.
`input`	object	Sí	Parámetros específicos de Actor, como prompt, mode o country.

Estructura de Datos del Resultado

Parámetro	Tipo	Requerido	Descripción
`status`	string	Sí	Estado de la tarea: `pending`, `running`, `success` o `failed`.
`message`	string	No	Mensaje de error si la tarea falla.
`task_result`	object	No	Carga útil completa para el actor. Consulte la documentación del actor para detalles a nivel de campo.

Carga Útil del Envío mediante Webhook

Si establece un webhook.url, Scrapeless realiza una solicitud POST con la siguiente estructura JSON:

Parámetro	Tipo	Requerido	Descripción
`task_id`	string	Sí	Identificador de la tarea completada.
`status`	string	Sí	`success` o `failed`.
`input`	string	Sí	Parámetros originales de la tarea serializados como JSON.
`task_result`	object	No	Misma estructura que recibiría al sondear el endpoint de resultados.

Ejemplo de envío

curl --location '{webhook.url}' \
  --header 'Content-Type: application/json' \
  --data '{
    "task_id": "",
    "status": "",
    "input": "",
    "task_result": {}
  }'

Códigos de estado HTTP

Estado	Significado
`200`	Éxito. El resultado ha sido recuperado.
`201`	Tarea creada correctamente.
`202`	La tarea aún se está ejecutando; inténtelo de nuevo pronto.
`400`	Solicitud no válida. Revise el mensaje de error para obtener más detalles.
`410`	Resultado de la tarea expirado. Los resultados permanecen disponibles durante 12 horas.
`429`	Límite de tasa excedido. Reduzca la frecuencia de solicitudes o aumente la capacidad.

Primeros pasos ChatGPT