API Übersicht

Die Paperoffice API folgt dem REST-Paradigma und liefert JSON-Antworten. Alle Endpunkte sind unter https://api.paperoffice.ai erreichbar.

Authentifizierung

• OAuth 2.0 Client Credentials Flow
• Gültigkeitsdauer der Tokens: 60 Minuten
• Erneuerung über Refresh Tokens oder erneute Client Credentials

Basis-URLs

Umgebung	Basis-URL
Produktion	https://api.paperoffice.ai
Sandbox	https://api-dev.paperoffice.ai

Rate Limits

Limit	Beschreibung
120 Requests/Minute	pro Mandant und Access Token
3000 Requests/Stunde	pro Mandant

Bei Überschreitung liefert die API 429 Too Many Requests inklusive Retry-After.

Fehlerbehandlung

Alle Fehler folgen dem Schema:

{
  "error": "invalid_request",
  "message": "Detailbeschreibung",
  "trace_id": "..."
}

Detaillierte Endpunkt-Beschreibungen findest du in der automatisch generierten API Referenz.