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 429 kontrollierte 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.