El contrato asíncrono
Toda integración se reduce a una idea: la extracción es asíncrona. Reproduzca el recorrido, muévase por él o aváncelo paso a paso.
Subida. Un solo POST lleva el archivo. Todavía no se ha leído nada.
Línea de tiempo
Con webhook_url, Parse le avisa al terminar y usted no consulta nada.
No se necesita tarjeta de crédito - 100 páginas al mes gratis
Envíe el archivo, guarde el id y pregunte por él hasta que cambie el estado. Todo lo demás - esquemas, exportaciones, webhooks - se apoya en esas dos llamadas.
# 1. submit - the call returns straight away
curl -X POST https://api-parse.conversiontools.io/v1/extract \
-H "Authorization: Bearer YOUR_API_KEY" \
-F "file=@invoice.pdf"
# 202 { "id": "ext_9f2c41d7", "status": "processing" }
# 2. poll that id until it stops saying "processing"
curl https://api-parse.conversiontools.io/v1/extractions/ext_9f2c41d7 \
-H "Authorization: Bearer YOUR_API_KEY"
# 200 { "status": "completed", "data": { ... } }POST /v1/extract devuelve un id al momento. Si su código se queda esperando datos en esa llamada, espera algo que nunca iba a llegar.
GET /v1/extractions/:id responde "processing" hasta que responde "completed". Un par de segundos entre llamadas es suficiente.
Pase webhook_url al enviar y Parse envía la extracción terminada a su endpoint. Sin bucles que escribir.
El plan gratuito incluye 100 páginas al mes y no hace falta tarjeta para empezar.