Co to znaczy
Żądanie się powiodło i utworzyło nowy zasób. Nagłówek Location zwykle na niego wskazuje.
Typowe przyczyny
- POST do kolekcji utworzył rekord
- PUT utworzył zasób pod nowym URL
Jak naprawić
Jako klient lub odwiedzający
Odczytaj nagłówek Location, aby poznać URL nowego zasobu, albo użyj zwróconej treści, jeśli API dołącza utworzony obiekt.
Jako właściciel strony lub API
Dołącz Location z nowym URL i najlepiej utworzoną reprezentację. Nie zwracaj 201, gdy nic nie powstało; powtórzenia idempotentne, które znajdują istniejący element, mogą zwrócić 200 lub 409.
Przykładowa odpowiedź
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"
}Specyfikacja
FAQ
› Czy nagłówek Location jest wymagany przy 201?
Jest zdecydowanie zalecany. Bez niego klienci muszą zgadywać nowy URL z treści.
› Jaka jest różnica między 201 a 202?
201 oznacza, że zasób już teraz istnieje. 202 oznacza, że żądanie przyjęto i zostanie przetworzone później.