202 Accepted
Der HTTP-Statuscode 202 Accepted
für erfolgreiche Antworten zeigt an, dass eine Anfrage zur Verarbeitung angenommen wurde, die Verarbeitung jedoch nicht abgeschlossen ist oder möglicherweise noch nicht begonnen hat. Die tatsächliche Verarbeitung der Anfrage ist nicht garantiert; eine Aufgabe oder Aktion kann fehlschlagen oder nicht zulässig sein, wenn ein Server versucht, sie zu verarbeiten.
Eine 202
-Antwort ist nicht verbindlich, was bedeutet, dass es keine Möglichkeit gibt, später eine asynchrone HTTP-Antwort zu senden, um das Ergebnis der Verarbeitung anzuzeigen. Dieser Antwortcode wird typischerweise verwendet, wenn die Anfrage von einem anderen Prozess oder Server bearbeitet wird oder wenn Anfragen stapelweise verarbeitet werden.
Status
202 Accepted
Beispiele
Automatisierte Aufgabe starten
Im folgenden Beispiel möchten wir einen Automatisierungsprozess starten, um Hundehalter per E-Mail über eine Abholaufgabe zu informieren:
POST /tasks HTTP/1.1
Host: example.com
Content-Type: application/json
{
"task": "emailDogOwners",
"template": "pickup"
}
Die Antwort zeigt, dass die Anfrage zur Startaufgabe zur Verarbeitung angenommen wurde. Eine URL wird im Antworttext gesendet, damit der Client Änderungen am Status der Aufgabe verfolgen kann:
HTTP/1.1 202 Accepted
Date: Wed, 26 Jun 2024 12:00:00 GMT
Server: Apache/2.4.1 (Unix)
Content-Type: application/json
{
"message": "Request accepted. Starting to process task.",
"taskId": "123",
"monitorUrl": "http://example.com/tasks/123/status"
}
Spezifikationen
Specification |
---|
HTTP Semantics # status.202 |