Rate-Limits und Wiederholungslogik
ApaleoPMS arbeitet mit zwei Rate-Limit-Ebenen: eine Ebene für Aufrufe der Kunden an ApaleoPMS-eigene Endpunkte (über die Custom-API-Erweiterung), eine Ebene für Aufrufe von ApaleoPMS gegen die Apaleo API.
Ebene 1 (Kunde an ApaleoPMS): Standard 5.000 Aufrufe pro Minute pro Token, mit Burst-Puffer bis 500 zusätzliche Aufrufe in einem 10-Sekunden-Fenster. Bei Überschreitung antwortet der Endpunkt mit HTTP 429 und einem Retry-After-Header. Bei Bedarf ist eine höhere Ratenklasse verhandelbar.
Ebene 2 (ApaleoPMS an Apaleo): unsere Aufrufe halten sich strikt an die von Apaleo dokumentierten Rate-Limits. Bei einem 429 aus Apaleo wenden wir eine exponentielle Wiederholungslogik an: 500 ms, 1,5 s, 4,5 s, 13,5 s, danach abbrechen und im Konnektor-Log dokumentieren.
Bei einem 5xx-Fehler aus Apaleo (z. B. während eines Apaleo-internen Deployments) wiederholen wir ebenfalls exponentiell, jedoch mit größeren Abständen: 2 s, 8 s, 32 s, 2 min, 8 min. Danach wird der Kunde über die E-Mail-Adresse aus der Konnektor-Konfiguration benachrichtigt.
Bei geplanten Apaleo-Wartungsfenstern (angekündigt in der Apaleo-Statuspage) pausiert ApaleoPMS sämtliche Rate- und Availability-Push-Aufrufe automatisch, um sinnlose Wiederholungen zu vermeiden.