Beschreiben Sie den Austausch
Für jede Operation dokumentieren Sie die Methode, Ressource, erforderliche Felder und das Format einer erfolgreichen Antwort. Fügen Sie einen Validierungsfehler hinzu. Unterscheiden Sie einen Transportfehler von einer abgelehnten Anfrage: Eine fehlende Antwort beweist nicht, dass eine zustandsändernde Operation fehlgeschlagen ist.
Behandeln Sie Anmeldeinformationen als Konfiguration
Halten Sie Server-Anmeldeinformationen außerhalb von Browser-Bundles und Quellcode-Repositories. Fordern Sie die kleinstmögliche praktische Berechtigung an und trennen Sie Entwicklungszugang vom Produktionszugang. Dokumentieren Sie, wer jede Integration besitzt und wie der Zugriff widerrufen werden kann. Folgen Sie dem dokumentierten Autorisierungsablauf des Anbieters.
Planen Sie für nicht verfügbare Abhängigkeiten
Setzen Sie Timeouts, beachten Sie Hinweise zur Ratenbegrenzung und wiederholen Sie Aktionen nur, wenn eine Operation sicher wiederholbar ist. Wo unterstützt, kann ein Idempotenzschlüssel wiederholte Anfragen identifizieren. Protokollieren Sie eine Anfrage-ID und eine kurze Fehlerkategorie; vermeiden Sie Autorisierungs-Header, Sitzungscookies und persönliche Nutzdaten.