API-Sicherheit, Rate Limits, Idempotenz und Support
Härtungsleitlinien für produktionssichere API-Integrationen.
Produktive Integrationen benötigen sichere Credential-Verwaltung, klare Retry-Regeln und idempotentes Client-Verhalten, wo unterstützt.
Sicherheit und Zugriffskontrolle
- Zugangsdaten sicher speichern und bei Vorfällen oder Ownership-Wechsel rotieren.
- Least-Privilege-Rollen/Scopes für Integrationsidentitäten nutzen.
- Request-IDs und Fehlercodes protokollieren für nachvollziehbare Eskalationen.
Rate-Limit- und Idempotenzleitlinien
- Bei
429kontrollierte Retry-Delays mit Backoff nutzen. - Idempotency-Keys verwenden, wo Flows dies unterstützen (z. B. Chat SendMessage).
- Doppelsendungen bei order-/zahlungsnahen Aktionen explizit im Client-Design absichern.
Erwartungen an technischen Support
- Bei Problemen Endpunkt, Request-ID, Zeitstempel und bereinigte Payload senden.
- Umgebung, erwartetes Verhalten und tatsächliches Verhalten immer mitgeben.
Gute Beobachtbarkeit und deterministische Retry-Logik sind der schnellste Weg zu stabilen Integrationen.