Cosa significa
La richiesta è riuscita e ha creato una nuova risorsa. L'header Location di solito punta a essa.
Cause comuni
- Un POST su una collezione ha creato un record
- Un PUT ha creato una risorsa a un nuovo URL
Come risolvere
Lato client o visitatore
Leggi l'header Location per ottenere l'URL della nuova risorsa, oppure usa il corpo restituito se l'API include l'oggetto creato.
Lato gestore del sito o dell’API
Includi Location con il nuovo URL e, idealmente, la rappresentazione creata. Non restituire 201 se non è stato creato nulla; i tentativi idempotenti che trovano un elemento esistente possono restituire 200 o 409.
Risposta di esempio
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"
}Specifica
Domande frequenti
› L'header Location è obbligatorio con 201?
È fortemente consigliato. Senza, i client devono indovinare il nuovo URL dal corpo.
› Che differenza c'è tra 201 e 202?
201 significa che la risorsa esiste già adesso. 202 significa che la richiesta è stata accettata e verrà elaborata più tardi.