Cosa significa
Il server richiede che la richiesta sia condizionale (If-Match ecc.) per evitare aggiornamenti persi.
Cause comuni
- PUT o PATCH senza If-Match su un'API che impone il locking ottimistico
Come risolvere
Lato client o visitatore
Fai GET della risorsa, prendi il suo ETag e invialo in If-Match con l'aggiornamento.
Lato gestore del sito o dell’API
Spiega nel corpo quale header è richiesto.
Risposta di esempio
HTTP/1.1
HTTP/1.1 428 Precondition Required
Date: Tue, 07 Oct 2025 09:30:00 GMT
Server: nginx
Content-Type: application/problem+json
{
"type": "about:blank",
"title": "Precondition Required",
"status": 428,
"detail": "Send If-Match with the ETag you last read."
}Specifica
Domande frequenti
› Perché un'API dovrebbe richiedere If-Match?
Per impedire che due client sovrascrivano le modifiche l'uno dell'altro senza accorgersene.
› 428 o 412?
428: non è stata inviata alcuna precondizione. 412: è stata inviata ma è fallita.