Abacus REST-API 2024 im Detail: Auth, Endpunkte, Webhooks

Technischer Tiefgang in die mit Abacus 2024 ausgelieferte REST-API: OAuth 2.0, Endpunkt-Struktur, Pagination, Webhooks und Rate-Limits — die Basis der präziis.-Integration.

OAuth 2.0 / OpenID Connect

Die Abacus REST-API 2024 verwendet OAuth 2.0 mit Client-Credentials-Flow für server-seitige Integrationen:

Client-ID und Client-Secret in Abacus konfigurieren
Token-Endpoint: POST /api/oauth/token mit grant_type=client_credentials
Access-Token hat eine Laufzeit von 3600 Sekunden
Token-Refresh: automatisch bei Expiry durch präziis.

Endpunkt-Struktur und Ressourcen

Die REST-API 2024 folgt einer einheitlichen Ressourcen-Hierarchie:

GET /api/projects — alle Projekte (mit Pagination)
GET /api/projects/{id} — einzelnes Projekt
GET /api/projects/{id}/members — Projektmitglieder
GET /api/customers — Kunden
GET /api/employees — Mitarbeitende

Pagination und Filtering

Grosse Datensätze werden via Cursor-Pagination abgerufen:

?pageSize=100&page=1 — erste 100 Einträge
?filter=status eq 'aktiv' — nur aktive Projekte
?orderBy=updatedAt desc — neueste zuerst
Link-Header enthält URL für nächste Seite

Webhooks für Echtzeit-Sync

Abacus 2024 unterstützt Webhooks für Push-Benachrichtigungen:

Webhook-Registration: POST /api/webhooks mit Callback-URL
Events: project.created, project.updated, project.closed
Authentifizierung: HMAC-SHA256-Signatur im Header
Retry-Logik bei Webhook-Fehlern (3 Versuche)

Rate-Limits und Performance

100 Anfragen/Minute pro API-Client
429 Too Many Requests mit Retry-After-Header
Batch-Import: bis zu 50 Datensätze pro Anfrage
Empfehlung: Delta-Sync statt Full-Sync für grosse Installationen