Rate Limits und Idempotency

Rate Limits schützen Ordinavo und angeschlossene Mandanten vor Überlastung oder missbräuchlicher Nutzung. Die konkreten Limits können je nach Projekt, Mandant und Integrationsart unterschiedlich sein.

Header

X-RateLimit-Limit: 1000
X-RateLimit-Remaining: 997
X-RateLimit-Reset: 1781548800
Retry-After: 60

Idempotency

Für schreibende Operationen sollte ein Idempotency-Key übergeben werden. Dadurch kann ein externes System denselben Request gefahrlos wiederholen, wenn es bei Netzwerkproblemen keine eindeutige Antwort erhalten hat.

Idempotency-Key: 7b56e4c2-2e7a-4b7c-bf44-291d2c9d1f91
Regel

Gleicher Idempotency-Key und gleicher Request-Inhalt liefern dasselbe Ergebnis. Gleicher Key mit anderem Inhalt wird als idempotency_conflict abgelehnt.

Schutzmechanismen

Ordinavo kann Integrationen begrenzen, pausieren oder blockieren, wenn ungewöhnliche Last, wiederholte Fehler oder Sicherheitsrisiken auftreten. Produktive Integrationen sollten Retry-After beachten und keine engen Polling-Schleifen verwenden.