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ámetro | Tipo | Obligatorio | Descripción |
|---|---|---|---|
actor | string | Sí | Identificador fijo que indica qué modelo deseas ejecutar. |
webhook | object | No | Objeto que contiene configuraciones opcionales de webhook. |
webhook.url | string | No | Endpoint HTTPS que recibe el resultado cuando finaliza la tarea. |
input | object | Sí | Parámetros específicos del actor, como prompt, modo o país. |
Estructura de datos del resultado
| Parámetro | Tipo | Obligatorio | 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 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ámetro | Tipo | Obligatorio | 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í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
| Estado | Significado |
|---|---|
200 | Éxito. El resultado ha sido recuperado. |
201 | Tarea creada correctamente. |
202 | La tarea sigue en ejecución; vuelve a intentarlo pronto. |
400 | Solicitud no válida o ejecución fallida. Revisa el mensaje de error para obtener detalles. |
410 | El resultado de la tarea ha expirado. |
429 | Límite de tasa superado. Reduce la frecuencia de solicitudes o aumenta tu capacidad. |