Schnellstart
Schlüssel erstellen, Spaces auflisten und ein erstes Dokument hochladen.
API-Schlüssel erstellen
Öffne Einstellungen → API-Schlüssel in der Webapp und erstelle einen Schlüssel mit spaces:read und documents:write. Das Geheimnis wird einmal angezeigt; kopiere es in deinen Secret Store.
export ADLASS_API_KEY='adl_live_…'Für die Entwicklung nutzt du https://dev.adlass.io/v1, die Entwicklungs-Webapp und einen adl_test_-Schlüssel. Jede Umgebung akzeptiert nur ihre eigenen Schlüssel.
Spaces auflisten
curl https://api.adlass.io/v1/spaces \
-H "Authorization: Bearer $ADLASS_API_KEY"Die Antwort enthält items und next_cursor. Merke dir eine Space-ID für den nächsten Schritt.
Upload registrieren
Schreibaufrufe brauchen einen Idempotency-Key; die SDKs setzen ihn automatisch.
curl https://api.adlass.io/v1/documents \
-H "Authorization: Bearer $ADLASS_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{"space_id":"SPACE_UUID","file_name":"bericht.pdf","content_type":"application/pdf","file_size":1024}'Datei hochladen und bestätigen
Hole mit GET /documents/{document_id}/upload-url eine vorsignierte URL, lade die Datei per PUT an presigned_url hoch und rufe dann POST /documents/{document_id}/confirm-upload mit einem neuen Idempotency-Key auf. Die 202-Antwort trägt einen Location-Header auf den Verarbeitungsjob; frage ihn ab, bis der Status COMPLETED ist.
Wie weiter
Lies zu Authentifizierung, Pagination und Fehlerbehandlung oder blättere durch die API-Referenz.