Overview

Legentio API 1

Öffentliche, vollständig asynchrone API von Legentio. Ein hochgeladenes Dokument wird nicht sofort verarbeitet: Der Upload kehrt umgehend zurück, die Ergebnisse werden anschließend per Polling abgeholt. Es gibt bewusst keinen Push-Kanal (keine Webhooks) – die Client-Anwendung besitzt die Polling-Schleife.

Alle Endpunkte authentifizieren sich mit einem Organisations-API-Schlüssel (Authorization: Bearer <key>). Der Schlüssel bindet jede Anfrage an genau eine Organisation; es sind ausschließlich deren Daten sichtbar.

Fehlerantworten haben immer den Body { "error": "…" } mit einer deutschen Meldung. 4xx sind Aufruf-Fehler (ungültige Datei, unbekannter Dokumenttyp, fehlerhafter Cursor), 5xx sind echte Serverprobleme.

Information

• OpenAPI version: 3.1.0

Operations

GET

/v1/scans

POST

/v1/scans

GET

/v1/scans/{scanId}

Authentication

orgApiKey

Organisations-API-Schlüssel als Authorization: Bearer <key>. Der Schlüssel bestimmt die Organisation und damit den Datenraum der Anfrage.

Security scheme type: http