DocumentaciónAI ScraperInicio rápidoCiclo de vida de la tarea

Detalles del ciclo de vida de la tarea

Utiliza la siguiente referencia para estructurar tus solicitudes e interpretar cada respuesta que la API de AI Scraper devuelve durante el ciclo de vida de una tarea.

Parámetros comunes de solicitud

ParámetroTipoObligatorioDescripción
actorstringSíIdentificador fijo que indica qué modelo deseas ejecutar.
webhookobjectNoObjeto que contiene configuraciones opcionales de webhook.
webhook.urlstringNoEndpoint HTTPS que recibe el resultado cuando finaliza la tarea.
inputobjectSíParámetros específicos del actor, como prompt, modo o país.

Estructura de datos del resultado

ParámetroTipoObligatorioDescripción
statusstringSíEstado de la tarea: pending, running, success o failed.
messagestringNoMensaje de error si la tarea falla.
task_resultobjectNoCarga útil completa del actor. Consulta la documentación del actor para obtener detalles a nivel de campo.

Carga útil del envío por webhook

Si configuras un webhook.url, Scrapeless envía una solicitud POST con la siguiente estructura JSON:

ParámetroTipoObligatorioDescripción
task_idstringSíIdentificador de la tarea completada.
statusstringSísuccess o failed.
inputstringSíParámetros originales de la tarea serializados como JSON.
task_resultobjectNoMisma estructura que recibirías al consultar 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

EstadoSignificado
200Éxito. El resultado ha sido recuperado.
201Tarea creada correctamente.
202La tarea sigue en ejecución; vuelve a intentarlo pronto.
400Solicitud no válida o ejecución fallida. Revisa el mensaje de error para obtener detalles.
410El resultado de la tarea ha expirado.
429Límite de tasa superado. Reduce la frecuencia de solicitudes o aumenta tu capacidad.