HTTP-Statuscodes verstehen

HTTP-Statuscodes sind dreistellige Zahlen, die der Server als Teil der Antwort zurücksendet, um den Client über den Ausgang der Anfrage zu informieren. Sie sind in fünf Kategorien eingeteilt, wobei jede Kategorie durch die erste Ziffer des Codes definiert wird.

Kategorien von Statuscodes

1xx: Informational (Informativ)

Diese Codes zeigen an, dass die Anfrage vom Server empfangen wurde und der Prozess noch läuft.

Code	Name	Beschreibung
100	Continue	Der Server hat den Anfrage-Header erhalten und erwartet nun den Body
101	Switching Protocols	Der Server wechselt das Protokoll (z.B. zu WebSockets)

2xx: Success (Erfolg)

Diese Codes zeigen an, dass die Anfrage erfolgreich empfangen, verstanden und akzeptiert wurde.

Code	Name	Beschreibung	Typische Verwendung
200	OK	Die Anfrage war erfolgreich	GET, PUT, POST, DELETE erfolgreich
201	Created	Eine neue Ressource wurde erstellt	POST, das neue Ressourcen anlegt
204	No Content	Die Anfrage war erfolgreich, aber es gibt keine Inhalte zurückzusenden	DELETE, PUT ohne Rückgabedaten

3xx: Redirection (Weiterleitung)

Diese Codes zeigen an, dass der Client weitere Massnahmen ergreifen muss, um die Anfrage abzuschliessen.

Code	Name	Beschreibung	Typische Verwendung
301	Moved Permanently	Die Ressource wurde dauerhaft an eine andere URL verschoben	Permanente URL-Änderungen
302	Found / Moved Temporarily	Die Ressource ist vorübergehend unter einer anderen URL zu finden	Temporäre Weiterleitungen
304	Not Modified	Die Ressource wurde seit der letzten Anfrage nicht geändert	Caching-Optimierung

4xx: Client Error (Client-Fehler)

Diese Codes zeigen an, dass die Anfrage vom Client einen Fehler enthält oder nicht bearbeitet werden kann.

Code	Name	Beschreibung	Typische Verwendung
400	Bad Request	Die Anfrage ist fehlerhaft	Falsche Parameter oder Syntax
401	Unauthorized	Authentifizierung erforderlich	Fehlende/falsche Login-Daten
403	Forbidden	Zugriff verweigert	Keine Berechtigung trotz Authentifizierung
404	Not Found	Die angeforderte Ressource wurde nicht gefunden	URL existiert nicht
409	Conflict	Konflikt mit aktuellem Zustand der Ressource	Versionskonflikt bei Updates
422	Unprocessable Entity	Die Anfrage ist syntaktisch korrekt, kann aber semantisch nicht verarbeitet werden	Validierungsfehler

5xx: Server Error (Server-Fehler)

Diese Codes zeigen an, dass der Server bei der Bearbeitung einer ansonsten gültigen Anfrage einen Fehler erfahren hat.

Code	Name	Beschreibung	Typische Verwendung
500	Internal Server Error	Ein unspezifischer Serverfehler ist aufgetreten	Unbehandelte Ausnahmen
502	Bad Gateway	Der Server fungierte als Gateway und erhielt eine ungültige Antwort	Probleme mit externen Diensten
503	Service Unavailable	Der Server ist vorübergehend nicht verfügbar	Überlastung oder Wartung
504	Gateway Timeout	Der Server fungierte als Gateway und erhielt keine rechtzeitige Antwort	Zeitüberschreitung bei externen Diensten

Häufige Statuscodes in der Praxis

Erfolgreiche Anfragen

• 200 OK: Standard-Erfolgsantwort
• 201 Created: Nach erfolgreicher Erstellung einer Ressource
• 204 No Content: Erfolg ohne Rückgabedaten (z.B. nach Löschen)

Clientseitige Fehler

• 400 Bad Request: Falsche Anfrageparameter oder Syntax
• 401 Unauthorized: Nicht authentifiziert
• 403 Forbidden: Keine Berechtigung
• 404 Not Found: Ressource existiert nicht
• 422 Unprocessable Entity: Validierungsfehler

Serverseitige Fehler

• 500 Internal Server Error: Allgemeiner Serverfehler
• 503 Service Unavailable: Server temporär nicht verfügbar

Statuscodes und HTTP-Methoden

Verschiedene HTTP-Methoden erwarten unterschiedliche Statuscodes:

Methode	Erwartete Erfolgscodes	Typische Fehlercodes
GET	200	404, 401, 403
POST	201, 200	400, 422, 409
PUT	200, 204	400, 404, 422
DELETE	204, 200	404, 403

Übung: Statuscodes mit JSONPlaceholder erkunden

Aufgabe: API-Anfragen und Statuscodes mit Postman

Für diese Übung werden Sie die kostenlose Test-API von JSONPlaceholder (https://jsonplaceholder.typicode.com/) verwenden, um verschiedene Statuscodes zu erkunden.

Aufgaben:

1. Erfolgreiche Anfrage (200 OK)

• Öffnen Sie Postman und erstellen Sie eine neue GET-Anfrage an https://jsonplaceholder.typicode.com/posts/1
• Senden Sie die Anfrage und beobachten Sie den Statuscode
• Welche Daten erhalten Sie zurück?

2. Ressource nicht gefunden (404 Not Found)

• Erstellen Sie eine GET-Anfrage an https://jsonplaceholder.typicode.com/posts/999
• Was ist der Statuscode?
• Wie unterscheidet sich die Antwort von der ersten Anfrage?

3. Neue Ressource erstellen (201 Created)

• Erstellen Sie eine POST-Anfrage an https://jsonplaceholder.typicode.com/posts
• Fügen Sie folgende JSON-Daten im Body hinzu (wählen Sie “raw” und “JSON”):

     {
       "title": "Mein neuer Beitrag",
       "body": "Dies ist der Inhalt meines Beitrags",
       "userId": 1
     }

• Welchen Statuscode erhalten Sie?
• Welche Daten gibt der Server zurück?

4. Ressource aktualisieren (200 OK)

• Erstellen Sie eine PUT-Anfrage an https://jsonplaceholder.typicode.com/posts/1
• Fügen Sie folgende JSON-Daten im Body hinzu:

     {
       "title": "Aktualisierter Titel",
       "body": "Dies ist der aktualisierte Inhalt",
       "userId": 1
     }

• Welchen Statuscode erhalten Sie?

5. Ressource löschen (200 OK)

• Erstellen Sie eine DELETE-Anfrage an https://jsonplaceholder.typicode.com/posts/1
• Welchen Statuscode erhalten Sie?
• Gibt es Daten in der Antwort?

6. Fehlerhafte Anfrage simulieren

• Erstellen Sie eine POST-Anfrage an https://jsonplaceholder.typicode.com/posts
• Senden Sie ungültiges JSON im Body (z.B. fehlendes Anführungszeichen):

     {
       "title": "Fehlerhafter JSON,
       "body": "Dies ist kein gültiges JSON",
       "userId": 1
     }

• Welchen Statuscode erwarten Sie? (Hinweis: Da JSONPlaceholder eine Demo-API ist, kann die Fehlerbehandlung von einer echten API abweichen)

Notieren Sie für jede Anfrage:

• Den erhaltenen Statuscode
• Die Art der Antwortdaten (falls vorhanden)
• Wie sich dieser Statuscode in einer echten Anwendung auswirken würde

Zusammenfassung

HTTP-Statuscodes sind ein wesentlicher Bestandteil der Webkommunikation und ermöglichen eine standardisierte Fehlerbehandlung:

• 1xx: Informative Nachrichten (selten verwendet)
• 2xx: Erfolgreiche Operationen (200 OK, 201 Created, 204 No Content)
• 3xx: Weiterleitungen (301 Moved Permanently, 302 Found)
• 4xx: Client-Fehler (400 Bad Request, 401 Unauthorized, 404 Not Found)
• 5xx: Server-Fehler (500 Internal Server Error, 503 Service Unavailable)

Das Verständnis von Statuscodes hilft Ihnen, API-Kommunikation zu debuggen und angemessen auf verschiedene Situationen zu reagieren. Im nächsten Kapitel werden wir Postman ausführlicher behandeln, um API-Anfragen strukturiert zu testen und zu analysieren.