Serverrespons 201 Created
Wat betekent de statuscode 201?
De HTTP-statuscode 201 (Created) geeft aan dat een nieuw resource succesvol is aangemaakt op de server. Deze code wordt vaak gebruikt in situaties waarin een aanvraag resulteert in de creatie van een object, zoals een gebruiker, een blogpost of een product in een online winkel.
Definitie en gebruik
De 201-statuscode is een bevestiging dat de aanvraag succesvol is verwerkt en dat er een nieuwe resource is aangemaakt. Dit houdt in dat de server een nieuw object heeft gecreëerd dat kan worden benaderd via een specifieke URI. De client ontvangt doorgaans ook informatie over de locatie van de nieuw aangemaakte resource in de header van het antwoord.
Context van toepassing in API
Bij het werken met API's wordt de 201-statuscode meestal gebruikt in combinatie met POST-aanvragen. Wanneer een client een POST-aanroep doet om een nieuwe resource te creëren, verwacht hij een 201-statuscode als bevestiging dat de creatie gelukt is. Dit is cruciaal voor interacties waarbij gegevens naar de server worden verzonden.
Praktische voorbeelden van het gebruik van code 201
Voorbeeld van succesvolle creatie van een gebruiker
Bij het aanmaken van een nieuwe gebruiker via een registratieformulier kan de server een 201-statuscode retourneren om aan te geven dat de gebruiker succesvol is aangemaakt.
Voorbeeld van het creëren van een nieuwe blogpost
Wanneer een auteur een nieuwe blogpost indient, kan de server een 201-statuscode teruggeven, vergezeld van de details van de nieuwe post.
Voorbeeld van het toevoegen van een product aan een webwinkel
Bij het toevoegen van een nieuw product aan een online catalogus kan de server ook een 201-statuscode retourneren als bevestiging van de succesvolle creatie.
Code 201: wanneer kan het optreden en hoe ermee om te gaan?
Redenen voor fouten bij het aanmaken van een resource
Er zijn verschillende redenen waarom een aanvraag mogelijk niet succesvol is, zelfs als een 201-statuscode wordt verwacht. Enkele veelvoorkomende oorzaken zijn:
- Onvoldoende gegevens in de aanvraag.
- Problemen met authenticatie of autorisatie.
- Serverfouten of configuratieproblemen.
Hoe een antwoord met code 201 correct te verwerken
Bij ontvangst van een 201-statuscode is het belangrijk om de details van de respons te controleren. Dit omvat het analyseren van de locatie van de nieuwe resource, die vaak in de 'Location' header van het antwoord is opgenomen.
Problemen met het aanmaken van een resource oplossen in verschillende programmeertalen
Voorbeeld in Python (gebruik van de requests-bibliotheek)
- Stuur een POST-verzoek naar de server met de benodigde gegevens.
- Controleer de statuscode van de respons.
- Als de statuscode 201 is, verwerk de gegevens.
Voorbeeld in JavaScript (gebruik van fetch API)
- Gebruik de fetch-functie om een POST-verzoek te doen.
- Verwerk de respons en controleer op een 201-statuscode.
- Gebruik de gegevens van de nieuw aangemaakte resource indien nodig.
Voorbeeld in PHP (gebruik van cURL)
- Stel een cURL-verzoek in om een nieuwe resource aan te maken.
- Controleer de statuscode van de respons.
- Verwerk de gegevens als de statuscode 201 is.
Verwerking van een succesvolle respons met code 201
Hoe de ontvangen gegevens te interpreteren
Bij een succesvolle creatie is het essentieel om de teruggegeven gegevens te analyseren, waaronder identificatie en relevante informatie over de aangemaakte resource. Dit helpt bij verdere interacties met de server.
Gebruik van de teruggegeven resource na creatie
Na ontvangst van de 201-statuscode en de bijbehorende gegevens kan de client de nieuwe resource gebruiken in vervolgacties, zoals het ophalen van aanvullende informatie of het bijwerken van de resource.
Aanbevelingen voor het werken met statuscode 201
- Volg de beste praktijken bij het ontwerpen van API's voor het aanmaken van resources.
- Test het proces van resourcecreatie grondig om de juiste statuscode en gegevens te waarborgen.
- Controleer altijd de headers van de respons voor aanvullende informatie over de aangemaakte resource.
| Type resource | Voorbeeld van aanvraag | Verwachte statuscode |
|---|---|---|
| Gebruiker | POST /users | 201 Created |
| Blogpost | POST /posts | 201 Created |
| Product | POST /products | 201 Created |