Referència de codis d'estat HTTP de franc

S'utilitza per a sol·licituds amb Expect: 100-continue. El servidor reconeix que està disposat a rebre el cos abans que el client l'enviï. Rarament es veu en aplicacions web modernes.

S'utilitza més comunament per a actualitzacions de WebSocket — el client sol·licita Upgrade: websocket i el servidor respon 101 per canviar.

Una resposta provisional de WebDAV enviada per evitar els temps d'espera del client durant operacions llargues. Obsoleta — els servidors moderns no la haurien d'enviar.

Permet als servidors enviar capçaleres de Link (preload/preconnect) mentre la resposta final es segueix preparant, de manera que els navegadors poden començar a obtenir els recursos crítics més aviat.

La resposta d'èxit estàndard. El significat depèn del mètode HTTP: GET → es retorna el recurs, POST/PUT → l'acció s'ha completat.

Comú després d'un POST. La resposta ha d'incloure una capçalera Location que apunti a l'URL del nou recurs.

Per a operacions asincronies — el servidor està posant en cua el treball. El client ha d'espiar un endpoint d'estat o comprovar més tard.

La sol·licitud va tenir èxit, però un intermediari (com un proxy de memòria cau o transformació) va alterar la càrrega útil del servidor d'origen — per exemple, recomprimint imatges. Rar en la pràctica.

Freqüentment s'utilitza per a operacions DELETE o actualitzacions PUT que no necessiten retornar un cos. El client no hauria de navegació lluny de la pàgina actual.

Com 204, no es retorna cap cos — però al client se li diu adicionalment que reinicii el formulari o la vista que va produir la sol·licitud (p. ex. netejar els camps del formulari per a la següent entrada).

Resposta a una sol·licitud de Range. Utilitzada pels lectors de vídeo i gestors de descàrregues per reprendre descàrregues interrompudes o transmetre fitxers grans.

WebDAV: un cos XML reporta el resultat de diverses suboperacions independentment — p. ex. un moviment en lot on alguns elements van tenir èxit i altres van fallar.

WebDAV: s'utilitza dins de respostes 207 Multi-Status per evitar llistar repetidament els membres de la mateixa col·lecció quan les vinculacions creen bucles.

Codificació delta: el servidor retorna una diferència respecte a una versió anterior en lloc del recurs complet, economitzant ample de banda. Molt rarament implementat.

El servidor ofereix múltiples opcions (p. ex. diferents formats o idiomes) i el client n'hauria de triar una. Rarament s'utilitza, perquè la negociació de contingut automàtica generalment ho maneja.

Utilitza-la per a canvis permanents d'URL — els motors de cerca actualitzaran el seu índex. L'autoritat SEO es transfereix a la nova URL.

Indica que la redirecció no és permanent. L'emmagatzematge en memòria cau és menys agressiu que 301. Utilitza-la per a coses com 'es requereix autenticació, redirigint a /login'.

Utilitzada després dels enviaments POST — la resposta diu 'el teu POST va funcionar, mira aquesta URL GET per al resultat'. Els navegadors sempre obtenen la nova URL.

Resposta a una sol·licitud condicional (amb capçaleres If-None-Match o If-Modified-Since). Economitza ample de banda — no es retorna cap cos.

Si l'original era POST, la redirecció també utilitza POST. Alternativa moderna a 302 quan la preservació del mètode és important.

Substitució moderna per 301 quan desitges que les sol·licituds POST romanguin POST després de la redirecció.

Causes comunes: JSON malformat al cos, paràmetres de consulta no vàlids, o camps necessaris que falten. Comprova el cos de la sol·licitud i les capçaleres.

El client ha d'incloure credencials d'autenticació (capçalera d'Autorització, cookie, token). 'No autoritzat' és un terme imprecís — realment significa 'no autenticat'.

Originalment destinada a pagaments digitals. Ús modern: les APIs de vegades retornen 402 quan un usuari ha excedit la seva quota de pagament.

Diferent de 401 — l'usuari ESTÀ autenticat, però el seu compte no té permís per a aquest recurs. Comprova la lògica de rol/permisos.

Sia l'URL és incorrecta, el recurs ha estat suprimit, sia mai va existir. Els servidors de vegades retornen 404 per amagar que 403 seria més precís.

Per exemple, una sol·licitud GET a un endpoint que només accepta POST. La resposta hauria d'incloure una capçalera Allow que llisti els mètodes vàlids.

El client va demanar un tipus de contingut, idioma, o codificació (via Accept, Accept-Language, Accept-Encoding) que el servidor no pot satisfer. Molts servidors s'eviten la negociació estricta i retornen una per defecte.

Com 401, però emès per un proxy: el client ha d'enviar credencials Proxy-Authorization. Vist en xarxes corporatives amb proxies autenticadors.

El client ha trigat massa temps per enviar el cos de la petició o ha mantingut la connexió inactiva. Torna a intentar la petició.

Normalment es retorna per a conflictes d'edició concurrent o creació de recursos duplicats (per exemple, crear un usuari amb un correu electrònic que ja existeix).

Més forta que 404 — el servidor explícitament sap que el recurs JA EXISTIA però ha estat eliminat permanentment. Els motors de cerca el desindexaran.

La petició ha estat rebutjada perquè li faltava una capçalera Content-Length i el servidor rebutja cossos de mida desconeguda. Afegeix la capçalera i torna a intentar.

Retornat quan capçaleres condicionals com If-Match o If-Unmodified-Since fallen — típicament bloqueig optimista: algú més ha canviat el recurs desde la teva versió. Refet i torna a intentar.

Comú quan s'carreguen fitxers grans. La configuració del servidor (nginx, apache) estableix una mida màxima de cos. Verifica la configuració del servidor.

Normalment causat per cadenes de consulta molt llargues (per exemple, codificació de dades en una GET). Canvia a un cos POST, o augmenta el límit del servidor si el controls.

Per exemple, enviant application/xml a un servidor que només accepta application/json. Estableix la capçalera Content-Type correctament.

La capçalera Range demana una part que el fitxer no té — per exemple, reprendre una descàrrega més allà del final del fitxer. La resposta hauria d'incloure Content-Range amb la mida real.

Enviat quan el servidor no suporta Expect: 100-continue. Alguns clients envien aquesta capçalera per defecte en POST grans; inhabilitar-la normalment resol l'error.

Una broma de Dia de Tots els Sants de 1998 (RFC 2324). Algunas APIs reals la utilitzen per a bromes o per marcar endpoints deprecats. No per a ús en producció.

Comú amb la reutilització de connexions HTTP/2: la petició ha arribat a un servidor que no està configurat per al nom d'host destí. El client hauria de reintentar en una connexió nova.

Per exemple, JSON analitzat correctament però faltava un camp requerit, o el valor d'un camp estava fora de rang. Comú en respostes de validació d'API REST.

WebDAV: el recurs origen o destí està bloquejat per un altre client, de manera que l'operació no pot procedir. Espera que el bloqueig es desloqui o trencar-lo amb el token apropiat.

WebDAV: en una cadena d'operacions dependents, una acció anterior ha fallat, per la qual cosa aquesta no ha estat realitzada. Mira el fallo anterior per a la causa arrel.

Relacionat amb TLS 1.3 0-RTT (dades d'inici): el servidor no arriscarà processant una petició possiblement replicada. El client hauria de reintentar després que l'handshake es completi.

El servidor es nega a servir la petició sobre el protocol actual però ho farà després d'una actualització — la resposta inclou una capçalera Upgrade que nomena el protocol requerit.

El servidor demana capçaleres condicionals (com If-Match) per a prevenir conflictes de pèrdua de dades. Obté el recurs, captura el seu ETag, i reenvía amb If-Match.

Relaxa't. La resposta hauria d'incloure una capçalera Retry-After indicant quan intentar-ho de nou. Comú amb APIs que tenen quotes de peticions.

O bé una capçalera o la mida total de capçaleres supera el límit — més sovint causada per cookies oversized. Buida les cookies o redueix el que la teva aplicació emmagatzema en elles.

El recurs està bloquejat per raons legals — censura, ordres judicials, o regulacions regionals. El número és una referència a la novel·la Fahrenheit 451.

Un genèric general per a errors del servidor. Verifica els registres del servidor per a la causa real: excepció no controlada, error de base de dades, etc.

Per exemple, el servidor no reconeix el mètode HTTP. Rar en la pràctica — més sovint veuràs 405.

Comú en arquitectures de microserveis. El vostre equilibrador de càrrega o proxy invers va obtenir una resposta malformada del servei backend.

O bé és offline per manteniment o sobrecarregat. La resposta hauria d'incloure una capçalera Retry-After. Sovint es retorna durant desplegaments.

El servei backend no va respondre prou ràpid. Verifica la salut del servei superior i les configuracions de temps limit.

La versió HTTP major de la petició no és suportada pel servidor. Gairebé mai vist amb clients moderns.

La negociació de contingut transparent ha acabat en un bucle: la variant triada està configurada elle mateixa per a negociar. Indica un error de configuració del servidor.

Específic de WebDAV en origen però a vegades utilitzat per servidors generals. Significa que el servidor no pot guardar la petició per limitacions d'emmagatzematge.

WebDAV: processant una petició Depth: infinity ha entrat en un bucle (per exemple, vincles circulars). L'operació ha estat finalitzada.

Des del framework HTTP Extension obsolet: el servidor necessita més informació abans de poder complir la petició. Efectivament no utilitzat al web modern.

Utilitzat per portals captius (hotel/aeroporto WiFi) per indicar que l'usuari ha de connectar-se a la xarxa abans de poder accedir a llocs externs.