201 Created oznacza, że żądanie zostało zrealizowane i utworzyło co najmniej jeden nowy zasób. API zwykle zwracają ten kod po żądaniu POST do kolekcji lub PUT pod nowy adres URL. Główny nowy zasób wskazuje nagłówek Location, a gdy odpowiedź nie zawiera Location – adres URL żądania.
Treść odpowiedzi zwykle opisuje nowy zasób lub zawiera do niego link. Walidatory w odpowiedzi, takie jak ETag, dotyczą nowo utworzonej reprezentacji, więc klient może ich użyć w kolejnych żądaniach warunkowych.
W przeciwieństwie do odpowiedzi 3xx nagłówek Location w odpowiedzi 201 nie jest przekierowaniem. Przeglądarki i klienci HTTP nie podążają za nim automatycznie.
Przykładowa odpowiedź
HTTP/1.1 201 Created
Date: Fri, 06 Nov 2026 10:15:32 GMT
Location: https://api.example.com/v1/orders/8412
Content-Type: application/json
Content-Length: 30
{"id":8412,"status":"pending"}SEO i sprawdzanie przekierowań
Kod 201 jest przeznaczony dla API i obsługi formularzy, a nie dla stron, które mają być indeksowane. Roboty, które go otrzymają, traktują go jako sukces, ale publiczny adres URL strony powinien zwracać 200. Po wysłaniu formularza w przeglądarce zwykle odpowiada się zamiast tego kodem 303 See Other, aby odświeżenie strony z wynikiem nie wysłało formularza ponownie.
Typowe przyczyny i zastosowania
- REST API utworzyło rekord (
POST /orders) i zwraca jego adres URL w nagłówkuLocation. - Plik został przesłany metodą
PUTpod adres URL, który wcześniej nie istniał. - Sprawdzanie przekierowań pokazuje 201 dla adresu URL, który miał być stroną: to endpoint API albo sprawdzenie odbyło się metodą POST. Sprawdź metodę HTTP w ustawieniach zaawansowanych.