Der asynchrone Vertrag

Sehen Sie einer Extraktion zu

Jede Integration hängt an einem Punkt: Extraktion ist asynchron. Spielen Sie den Ablauf unten ab, navigieren Sie darin oder gehen Sie ihn Schritt für Schritt durch.

sample-invoice.pdf0/3 Seiten0/20 Feldert+0.00s

Upload. Ein POST überträgt die Datei. Gelesen wurde noch nichts.

Dokument

wartet auf die Datei

Seite 1 von 3

Konsole

Ergebnis

entsteht auf dem Server

// noch nichts - die Engine hat kein Feld gefunden

Zeitachse

POSTPOST /v1/extractSie

extractextraction (server)Server

GET :idGET /v1/extractions/:idSie, in Schleife

webhookwebhook_urlstatt Polling

POST exportPOST /v1/extractions/:id/exportSie

0s2s4s6s8s10s12s

Mit webhook_url meldet sich Parse bei Ihnen, sobald es fertig ist - ganz ohne Polling.

läuft

Kostenlos starten - 100 Seiten

Keine Kreditkarte erforderlich - 100 Seiten/Monat kostenlos

Zwei Aufrufe, das ist die Integration

Datei senden, ID behalten, abfragen bis sich der Status ändert. Alles Weitere - Schemas, Exporte, Webhooks - baut auf diesen zwei Aufrufen auf.

Zum Schnellstart

terminal

# 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": { ... } }

Senden heißt nicht warten

POST /v1/extract gibt sofort eine ID zurück. Wer bei diesem Aufruf auf Daten wartet, wartet auf etwas, das dort nie kommt.

Fragen Sie die ID ab, nicht die Datei

GET /v1/extractions/:id antwortet "processing", bis es "completed" antwortet. Ein paar Sekunden Abstand zwischen den Aufrufen genügen.

Oder lassen Sie sich benachrichtigen

Übergeben Sie beim Senden webhook_url, und Parse schickt die fertige Extraktion an Ihren Endpunkt. Keine Schleife nötig.

Mit Ihrem eigenen Dokument testen

Der kostenlose Tarif umfasst 100 Seiten pro Monat, für den Start ist keine Kreditkarte nötig.

Jetzt extrahieren API-Referenz