Detalles del ciclo de vida

Usa la siguiente referencia para modelar tus peticiones y comprender cada respuesta que devuelve la API LLM Chat Scraper.

Parámetros comunes de la petición

Parámetro	Tipo	Obligatorio	Descripción
`actor`	string	Sí	Identificador fijo que indica qué modelo quieres ejecutar.
`webhook`	object	No	Objeto con los ajustes opcionales del webhook.
`webhook.url`	string	No	Endpoint HTTPS que recibirá el resultado al finalizar.
`input`	object	Sí	Parámetros específicos del actor (prompt, modo, país, etc.).

Estructura 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	Payload completo del actor; revisa la documentación de cada modelo para ver los campos exactos.

Payload del Webhook

Si configuras webhook.url, Scrapeless enviará una petición POST con el siguiente JSON:

Parámetro	Tipo	Obligatorio	Descripción
`task_id`	string	Sí	Identificador de la tarea finalizada.
`status`	string	Sí	`success` o `failed`.
`input`	string	Sí	Parámetros originales serializados como JSON.
`task_result`	object	No	El mismo objeto que obtendrías al consultar el endpoint de resultados.

Ejemplo de push

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

Códigos de estado HTTP

Código	Significado
`200`	Resultado recuperado correctamente.
`201`	Tarea creada con éxito.
`202`	La tarea sigue en ejecución; inténtalo de nuevo más tarde.
`400`	Petición inválida; revisa el mensaje de error.
`410`	El resultado expiró (se conserva 12 horas).
`429`	Límite de peticiones excedido.

Empezando ChatGPT