Test 202 Akzeptiert und asynchrone Jobabfrage

Der Statuscode 202 „Akzeptiert“ wird von Clients am häufigsten falsch interpretiert, da er eine Erfolgsmeldung für einen noch nicht abgeschlossenen Vorgang darstellt. Das Protocol Lab modelliert den gesamten Ablauf: Absenden, Empfangen des Statuscodes 202 mit einer Status-URL, regelmäßiges Abfragen bis zum Abschluss des Vorgangs und anschließende Behandlung des fehlgeschlagenen Vorgangs.

Asynchrone Jobtests — request and response sequence Sequence diagram for Async job testing: POST /protocol/v1/jobs answers 202 Accepted. GET /protocol/v1/jobs/{id} answers 200 OK. GET /protocol/v1/maintenance answers 503 Service Unavailable. GET /protocol/v1/gateway-timeout answers 504 Gateway Timeout. Your client Fun API Playground POST /protocol/v1/jobs 202 Accepted Einen asynchronen Job starten — 202 Akzeptiert GET /protocol/v1/jobs/{id} 200 OK Umfrage zu einem Job – Fortschritte bei jeder Umfrage GET /protocol/v1/maintenance 503 Service Unavailable Geplante Wartungsarbeiten — 503 + Wiederholungsversuch GET /protocol/v1/gateway-timeout 504 Gateway Timeout Langsame Upstream-Anfrage – wartet ca. 3 Sekunden, dann 504
Echte Endpunkte aus dem Katalog – jede der oben genannten Anfragen wird bedient, und jeder angezeigte Statuscode ist ein Statuscode, den dieser Endpunkt tatsächlich zurückgibt.

Wie man es übt

  1. Starten Sie einen Job, lesen Sie Location aus der Antwort 202 und fragen Sie den Status ab, statt den Abschluss vorauszusetzen.
  2. Verwenden Sie ein sinnvolles Abfrageintervall und eine Versuchslimitierung. Vermeiden Sie eine Endlosschleife bei Jobs ohne Abschluss.
  3. Behandeln Sie einen fehlgeschlagenen Job: Die Statusabfrage kann erfolgreich sein, obwohl die eigentliche Arbeit fehlschlug.
  4. Prüfen Sie das Clientverhalten, wenn der Job den gesamten Timeout überschreitet.
  5. Kombinieren Sie die Abfragen mit den Endpunkten für 503 und 504, um unzuverlässige vorgelagerte Dienste zu simulieren.

APIs, um es auszuprobieren

Betroffene Statuscodes

Andere Techniken

Einstiegsanleitung · Alle 39 Mock-REST-APIs

Zuletzt aktualisiert