Aletura · API
Verträge per API analysieren
Dieselbe Analyse wie im Web — als HTTP-API: Datei per POST senden, strukturiertes JSON zurück. Es gelten dieselben Kontingente und Dateigrenzen wie in der Weboberfläche.
Schnellstart
Vier Schritte mit curl. Jeder schreibende Aufruf sendet das Sitzungs-Cookie plus den CSRF-Header.
Sitzung und CSRF-Cookie holen
ShellSitzung + CSRFcurl -c cookies.txt https://aletura.eu/api/auth/session TOKEN=$(grep XSRF-TOKEN cookies.txt | awk '{print $NF}')Optional Für das Individual-Kontingent anmelden
ShellKontositzungcurl -b cookies.txt -c cookies.txt -H "X-XSRF-TOKEN: $TOKEN" \ -d "username=du@example.eu&password=dein-passwort" \ https://aletura.eu/api/auth/loginVertrag analysieren
ShellMultipart-Uploadcurl -b cookies.txt -H "X-XSRF-TOKEN: $TOKEN" \ -F "file=@vertrag.pdf" \ https://aletura.eu/api/reviewsDie Antwort ist das strukturierte Ergebnis als JSON. Falls eine Kontextbestätigung nötig ist, kommt 400 — dann
POST /api/reviews/prepareundPOST /api/reviews/preparations/{preparationId}/completeverwenden.Fortschritt pollen oder abbrechen
ShellVorgangsstatuscurl -b cookies.txt -H "X-XSRF-TOKEN: $TOKEN" \ https://aletura.eu/api/progress/{operationId} # 200 mit Fortschritt, 204 wenn fertig/unbekannt curl -b cookies.txt -H "X-XSRF-TOKEN: $TOKEN" -X DELETE \ https://aletura.eu/api/progress/{operationId} # abbrechen; Kontingent wird erstattet
Grenzen — identisch zur Weboberfläche
- Gäste: 1 erfolgreicher Vorgang pro Gerät und UTC-Tag (anonymes Geräte-Token; eine gehashte IP-Abhärtung bleibt als Missbrauchsschutz aktiv). Individual-Konten: 3 pro Tag. Jedes fertige Ergebnis erlaubt 5 Folgefragen.
- Fehlgeschlagene, abgebrochene oder unbrauchbare Vorgänge werden automatisch erstattet.
- Eine Datei: max. 20 MB, bis zu 80 Seiten und höchstens 3 OCR-Seiten in der aktiven Bereitstellung (technische Höchstgrenze: 300 Seiten). Formate: PDF, DOCX, TXT. Der Uploader zeigt die aktuell gültigen Zulassungsgrenzen.
- Vergleiche nehmen 2–3 Dateien und zählen als ein Vorgang (
POST /api/comparisons/prepare); technische Höchstgrenzen: 40 MB und 600 Seiten insgesamt. - Der Klausel-Schnellcheck ist auf den gelieferten Text begrenzt (max. 20.000 Zeichen) oder eine Datei bis 5 MB / 5 Seiten.
- Bei Kontingent-Erschöpfung: HTTP 429 mit JSON-Fehlerkörper.
OpenAPI- / Swagger-Spezifikation
Der vollständige maschinenlesbare Vertrag inklusive Authentifizierung, Parametern und Fehlerformen:
openapi.json herunterladen (Swagger)
Importierbar in Swagger UI, Postman oder OpenAPI-Codegen. Die API-Version ist 1.0.0; Bruchänderungen gäbe es als neue Version.
Datenschutz und Speicherung
Erkannte personenbezogene Daten werden lokal maskiert, bevor ein Modell aufgerufen wird; das Modell sieht nur Platzhalter. Uploads, extrahierte Texte und Zuordnungen werden nicht gespeichert, sofern du nicht ausdrücklich ein Ergebnis aus einem angemeldeten Konto speicherst. Die Analyse läuft über den konfigurierten Mistral-Endpunkt für regionale EU-Inferenz.
