Cómo funciona
Todas las solicitudes son asíncronas. Envías una tarea, la ponemos en cola, un worker consulta el motor de destino y extrae el resultado, que te llega por webhook o mediante sondeo.1
Envía una tarea
POST /v1/async/task con un taskType y un payload. Recibes al instante un id de tarea con estado QUEUED.2
Consultamos el motor
Un worker toma la tarea, consulta el motor y extrae el texto de la respuesta, las fuentes y los datos extra
propios de cada motor.
3
Recoge el resultado
Si indicaste
webhook.url, enviamos el resultado por POST a esa URL. Si no, consulta
GET /v1/async/task/{id} hasta que status sea COMPLETED o FAILED.Qué recibes
Sea cual sea el motor, el núcleo útil de cada resultado tiene la misma forma:string
La respuesta del motor en texto plano.
array
Las citas que el motor adjuntó a su respuesta:
position, url y normalmente label.URL base
/health y /ready requieren un token bearer.
Empieza aquí
Envía tu primera tarea y recibe un resultado en menos de cinco minutos.