Wat het betekent
Het verzoek is geslaagd en heeft een nieuwe resource aangemaakt. De Location-header wijst er meestal naar.
Veelvoorkomende oorzaken
- POST naar een collectie heeft een record aangemaakt
- PUT heeft een resource op een nieuwe URL aangemaakt
Zo los je het op
Als client of bezoeker
Lees de Location-header voor de URL van de nieuwe resource, of gebruik de body als de API het aangemaakte object meestuurt.
Als beheerder van de site of API
Stuur Location mee met de nieuwe URL en bij voorkeur de aangemaakte representatie. Geen 201 als er niets is aangemaakt; idempotente herhalingen die een bestaand item vinden kunnen 200 of 409 geven.
Voorbeeldantwoord
HTTP/1.1
HTTP/1.1 201 Created
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Location: /users/42
Content-Type: application/json
{
"id": 42,
"name": "Ada"
}Specificatie
Veelgestelde vragen
› Is de Location-header verplicht bij 201?
Hij wordt sterk aanbevolen. Zonder moeten clients de nieuwe URL uit de body raden.
› Wat is het verschil tussen 201 en 202?
201 betekent dat de resource nu al bestaat. 202 betekent dat het verzoek is aangenomen en later wordt verwerkt.