Quickstart

Ein API-Key aus dem Dashboard (Format exk_live_…). Er wird bei jedem Request als Bearer-Token mitgeschickt.

curl -X POST https://api.extract.adlass.io/v1/uploads \
  -H "Authorization: Bearer exk_live_..."

# → { "upload_id": "…", "upload_url": "https://…" }

Die upload_url ist eine zeitlich begrenzte Presigned URL — das PDF wird direkt in den Storage geladen und läuft nicht durch den API-Prozess.

curl -X PUT "<upload_url>" \
  -H "Content-Type: application/pdf" \
  --data-binary @befund.pdf

curl -X POST https://api.extract.adlass.io/v1/analyses \
  -H "Authorization: Bearer exk_live_..." \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: mein-eindeutiger-schluessel" \
  -d '{
    "upload_id": "<upload_id>",
    "outputs": ["diagnoses", "clusters"],
    "webhook_url": "https://ihre-domain.de/webhooks/extract"
  }'

# → 202 { "id": "…", "status": "queued" }

Bei der Anlage wird die Seitenzahl gezählt und Seiten × Stufenfaktor Credits reserviert (diagnoses 7, clusters +3 pro Seite). Reicht das Guthaben nicht, antwortet die API mit 402. webhook_url ist optional — ohne sie greift der Account-Endpoint aus dem Dashboard, und Polling funktioniert immer.

curl https://api.extract.adlass.io/v1/analyses/<id> \
  -H "Authorization: Bearer exk_live_..."

# solange status "queued" | "processing":
# → { "id": "…", "status": "processing" }

# bei Erfolg:
# → {
#     "status": "succeeded",
#     "usage": { "pages": 12, "credits": 120 },
#     "diagnoses": [ { "label": "…", "icd10": "…", "evidence": [ … ] } ],
#     "clusters": [ … ]
#   }

Abgerechnet wird nur bei succeeded; bei failed (auch Timeout oder unlesbares Dokument) wird die Reservierung vollständig freigegeben. Ergebnisse sind 7 Tage nach Abschluss abrufbar, danach werden sie gelöscht.

60 Requests/min pro Key, maximal 5 gleichzeitig laufende Analysen, 300 Seiten bzw. 100 MB pro Dokument. Höhere Limits sind pro Konto möglich — melden Sie sich.