HTTP 201 Created: Bedeutung

Was dieser Fehler bedeutet und wie du ihn erkennst

• Ein API-Client, eine browserbasierte Anwendung, ein Monitoring-Tool oder ein Checker meldet 201 Created.
• Die Antwort kann ein neu erstelltes Objekt, Metadaten der Ressource oder einen Location-Header enthalten.
• Das Ergebnis kann nur bei einer bestimmten Route, HTTP-Methode, einem bestimmten Konto oder Request-Payload auftreten.
• Eine erfolgreiche 201-Antwort kann im Response-Body von Warnungen oder Validierungsdetails auf Anwendungsebene begleitet werden.
• DNS- und TLS-Prüfungen können weiterhin erfolgreich sein, weil ein HTTP-fähiger Endpunkt eine Antwort zurückgegeben hat; diese Prüfungen sind vom HTTP-Status getrennt.

Hauptursachen nach Wahrscheinlichkeit

1. Erwartete Ressourcenerstellung: Die Route erstellt absichtlich einen Datensatz, ein Konto, einen Upload, einen Job, eine Bestellung oder eine andere Ressource und gibt nach erfolgreicher Erstellung 201 zurück.
2. Eine ressourcenerstellende Methode wurde verwendet: Der Client hat eine POST- oder PUT-Anfrage an einen Endpunkt gesendet, der für die Erstellung einer Ressource vorgesehen ist. Ob 201 angemessen ist, hängt von Methode und Route ab.
3. Die Anfrage wurde wiederholt oder an die falsche Route gesendet: Ein Client, eine Integration oder ein Formular kann einen Erstellungs-Endpunkt ansprechen, obwohl eine bestehende Ressource aktualisiert oder eine andere URL verwendet werden sollte.
4. Anwendungs- oder Routing-Verhalten wurde geändert: Ein Deployment, Controller, Handler oder eine Routenregel kann den für eine Anfrage zurückgegebenen Status geändert haben.
5. Ein Vermittler hat die Antwort erzeugt oder verändert: Ein Reverse Proxy, CDN, WAF oder Gateway kann beteiligt sein, insbesondere wenn sich die Header zwischen direkten und öffentlichen Anfragen unterscheiden.
6. Die Interpretation durch den Client ist irreführend: Eine Monitoring-Regel kann jede HTTP-Antwort ohne Fehlerstatus als ungewöhnlich einstufen, obwohl 201 für diesen Endpunkt gültig ist.

So behebst du den Fehler

Zuerst feststellen, ob HTTP 201 erwartet wird

1. Notieren Sie die genaue URL, HTTP-Methode, den Request-Body oder relevante Parameter, den Kontokontext und den Zeitstempel. Nehmen Sie Passwörter, Cookies, Access-Tokens oder andere Geheimnisse nicht in gemeinsam genutzte Notizen auf.
2. Prüfen Sie das dokumentierte Verhalten des Endpunkts oder den Anwendungskontrakt. Ein Erstellungs-Endpunkt gibt häufig 201 zurück; eine Anfrage an eine schreibgeschützte Seite sollte normalerweise keine Ressource erstellen.
3. Prüfen Sie Response-Body und Header. Achten Sie auf einen Location-Header, eine Ressourcen-ID, den Content-Type, eine Request-ID, Cache-Informationen und Warnungen auf Anwendungsebene. Betrachten Sie Header als Indizien, nicht als Beweis dafür, dass eine bestimmte Komponente die Antwort erzeugt hat.
4. Bestätigen Sie, ob der Client Weiterleitungen verfolgt oder eine Zwischenantwort gemeldet hat. Halten Sie die endgültige Antwort getrennt von früheren Antworten fest.

Wenn Sie API-Nutzer oder Besucher sind

1. Wenn der Vorgang etwas erstellen sollte, überprüfen Sie in der Anwendung, ob die neue Ressource vorhanden ist, bevor Sie die Anfrage erneut senden.
2. Wenn der Vorgang nichts erstellen sollte, stoppen Sie wiederholte Wiederholungen und prüfen Sie Route, HTTP-Methode und Client-Konfiguration.
3. Wenn eine Authentifizierung erforderlich ist, melden Sie sich über den normalen Anwendungsablauf an und wiederholen Sie den Vorgang nur, wenn dies sicher und autorisiert ist.
4. Übermitteln Sie dem Betreiber der Website die bereinigte URL und Methode, den Zeitstempel, relevante Response-Header und, falls vorhanden, die Request-ID. Teilen Sie niemals Zugangsdaten, Session-Cookies oder API-Geheimnisse.

Wenn Sie die Anwendung oder Website betreiben

1. Reproduzieren Sie die Anfrage in einer sicheren Umgebung oder mit einem autorisierten Testkonto. Erfassen Sie Methode, URL, Status, Response-Header und einen von sensiblen Daten bereinigten Response-Body.
2. Ermitteln Sie, welche Komponente die Antwort erzeugt hat: Application-Handler, Webserver, Reverse Proxy, CDN, WAF oder ein anderes Gateway. Vergleichen Sie vom Server erzeugte Request-IDs oder Timing-Header, soweit verfügbar, mit den Logs.
3. Prüfen Sie die passenden Anwendungs- und Infrastruktur-Logs zum aufgezeichneten Zeitpunkt. Bestätigen Sie, ob tatsächlich eine Ressource erstellt wurde und ob der Vorgang einmal oder mehrmals festgeschrieben wurde.
4. Überprüfen Sie kürzlich vorgenommene Änderungen an Routen, Controllern, Request-Verarbeitung, Authentifizierung, Proxy-Regeln und Deployments. Achten Sie besonders auf Clients, die nicht idempotente Erstellungsanfragen wiederholen können.
5. Wenn 201 für den Endpunkt falsch ist, ändern Sie die engste Anwendungs- oder Routing-Regel, die die Antwort steuert. Holen Sie eine Genehmigung ein und testen Sie die Änderung, bevor Sie sie in der Produktion anwenden.
6. Testen Sie anschließend erneut mit derselben Methode, URL und demselben Payload. Prüfen Sie danach zugehörige Create-, Read- und Update-Routen, um sicherzustellen, dass die vorgesehenen Statuscodes und das Ressourcenverhalten weiterhin korrekt sind.

Vorbeugung und Überprüfung der Lösung

• Definieren Sie erwartete HTTP-Methoden und Statuscodes für jede öffentliche Route, einschließlich des Verhaltens bei Erstellung und doppelten Anfragen.
• Testen Sie Create-, Read- und Update-Vorgänge nach Deployments mit repräsentativen authentifizierten und nicht authentifizierten Fällen.
• Sorgen Sie dafür, dass Clients 201 ausdrücklich verarbeiten und die zurückgegebene Ressource oder den Location-Header überprüfen, bevor sie die Anfrage wiederholen.
• Verwenden Sie Request-IDs und bewahren Sie Anwendungs-, Proxy- und Gateway-Logs lange genug auf, um eine unerwartete Antwort zurückzuverfolgen.
• Überwachen Sie Statuscode-Raten nach Route und Methode, anstatt jede 2xx-Antwort als gleichwertig zu behandeln.
• Halten Sie Routing-, Authentifizierungs-, Proxy- und Anwendungsänderungen versionskontrolliert und dokumentieren Sie beabsichtigte 201-Antworten.

Häufig gestellte Fragen