No mundo do desenvolvemento web, os códigos de erro HTTP xogan un papel vital ao afectar a experiencia do usuario e a reputación dun sitio web. Neste artigo, consideraremos unha lista completa de códigos de erro do servidor, analizaremos os seus significados e aprenderemos a interpretar de forma eficaz os códigos de resposta do servidor para resolver problemas e optimizar o rendemento das aplicacións web.
Que é un código de resposta HTTP
O código de resposta HTTP é a linguaxe dos servidores web que traduce as solicitudes do navegador en instrucións comprensibles. É como un poeta respondendo preguntas virtuais, dándolles sentido e dirección. Os códigos de resposta non sempre son códigos de erro HTTP. Por exemplo, "200 OK" significa que todo está ben, pero o erro HTTP "404 Not Found" significa que a páxina se perde no espazo virtual. Cada código é unha expresión única do estado do servidor, cuxa decodificación permite comprender o que está a suceder ao outro lado do mundo virtual.
Códigos 1xx (información)
Os códigos de estado 1xx no protocolo HTTP son unha especie de primeira ligazón no diálogo entre o servidor e o cliente. En lugar de proporcionar unha resposta completa a unha solicitude, proporcionan información sobre o estado actual, facendo que o intercambio de datos sexa máis eficiente. Vexámolos máis de cerca:
100 Continuar . Código de resposta HTTP no que o servidor dá luz verde ao usuario, o que lle permite continuar enviando unha solicitude grande de forma segura.
101 Protocolos de cambio . O servidor indica ao cliente que está a cambiar as regras do xogo, por exemplo, pasando de HTTP ao HTTPS, que é máis seguro. Neste caso, a cabeceira «Actualización» úsase para o cambio de protocolo.
102 Procesamento . Este código é coma unha mensaxe que indica que o servidor aceptou a solicitude, pero que aínda está ocupado cunha operación complexa.
103 pistas iniciais . Aquí o servidor envía varias cabeceiras indicativas ao cliente antes da resposta principal, avisando sobre algo que pode ser relevante nun futuro próximo.
Código 2xx (correcto)
Os códigos de erro HTTP do grupo 2xx indican unha solicitude exitosa do servidor. Funcionan esencialmente como "luz verde" no ámbito das comunicacións web, confirmando que todo vai segundo o previsto e que se completou con éxito.
200 OK . Este estado úsase cando o servidor procesa unha solicitude mediante o método GET sen problemas e devolve os datos solicitados en resposta. A cabeceira "Content-Type" informa do tipo de contido na resposta. Simplemente informa ao cliente de que a solicitude tivo éxito.
201 Creado . Aquí o servidor anuncia a creación dun novo recurso.
202 Aceptado . O servidor informa ao usuario de que a solicitude foi aceptada, pero tardará en responder.
203 Información non autorizada . Este código proporciona ao cliente datos que poden non ser oficiais, pero que se poden empregar para comparacións.
204 Sen contido . O servidor procesou a solicitude pero non devolve ningún contido adicional.
205 Restablecer contido . Aquí indícaselle ao cliente que restableza a vista ou os datos actuais despois do envío.
206 Contido parcial . Este caso indica que a resposta só contén unha parte do contido solicitado. A cabeceira "Content-Range" indica o rango de contido parcial.
207 Multiestado. O servidor completou correctamente unha solicitude multioperación do cliente e a resposta contén información sobre o estado de cada unha das operacións.
226 IM usado . Este código indica que o servidor empregou o método de metadatos incrementais (IM) e respondeu pasando só as partes de recursos modificadas ao cliente.
Códigos 3xx (redireccións)
Os códigos 3xx no protocolo HTTP son como punteiros que guían ao usuario cara a unha nova localización do recurso. Infórmanlle ao cliente de que se deben seguir pasos para obter o contido solicitado ou para ser redirixido a outro recurso. Mergullémonos nos detalles de cada un deles:
300 opcións múltiples . O cliente recibe un sinal de que hai varias localizacións posibles para o recurso e ofrécese unha opción en resposta. Nas circunstancias actuais, a cabeceira "Localización" pode indicar opcións alternativas para o recurso.
301 Movido permanentemente. O servidor informa ao usuario de que o recurso foi movido permanentemente a outra localización.
Atopouse un erro 302. Este código HTTP é similar a un redireccionamento temporal. O servidor informa ao consumidor de que o recurso está dispoñible temporalmente nun URL diferente. A cabeceira "Localización" apunta ao novo URL para o redireccionamento temporal.
303 Véxase Outros . Indícaselle ao cliente que o recurso está dispoñible nun URL diferente e que debe facer unha solicitude GET a este novo enderezo.
304 Sen modificar . Este estado indica ao cliente que o recurso permaneceu sen cambios desde a última solicitude e que non é necesario descargalo de novo. Ao facer unha solicitude, a cabeceira "If-Modified-Since" úsase para comprobar se o recurso foi modificado.
305 Usar proxy. Como resposta, o servidor informa que debería usar o proxy especificado para acceder ao recurso solicitado.
306 (reservado) : o código foi reservado, pero en realidade non se usa.
Redireccionamento temporal 307. Este código é semellante ao 302 Atopado, pero require que o cliente permaneza no método de solicitude que se empregou na solicitude orixinal.
308 Redireccionamento permanente . Indica que o recurso se moveu permanentemente a un novo URI e que o cliente debe usar o novo URI para todas as solicitudes futuras.
Erro HTTP 4xx (erros de cliente)
Os códigos de erro HTTP 4xx indican erros do cliente. Isto significa que o problema está do lado do usuario, como o navegador web ou a aplicación.
400 Solicitude incorrecta . O servidor non pode procesar a solicitude debido a erros de sintaxe, datos non válidos ou outros erros no lado do cliente.
401 Non autorizado. O servidor non pode procesar a solicitude debido a erros de sintaxe, datos non válidos ou outros erros no lado do cliente.
Pago 402 requirido . O código non está activo neste momento e está reservado para uso futuro. Pode indicar a necesidade de pagar antes de acceder ao recurso no futuro.
Erro HTTP 403 Prohibido. O cliente non ten dereitos suficientes para acceder ao recurso solicitado.
404 Non atopado. O recurso solicitado non existe no servidor. Este é un dos erros de usuario máis comúns.
Método 405 non permitido . O servidor non admite o método de solicitude especificado durante este recurso. A cabeceira "Permitir" indica os métodos permitidos para o recurso. Con este código,
406 Non aceptable. O servidor non pode fornecer datos nun formato que o cliente poida aceptar.
407 Requírese autenticación de proxy . É necesaria a autenticación no servidor proxy para acceder ao recurso solicitado.
408 Tempo de espera da solicitude . O servidor estaba esperando para recibir unha solicitude do cliente, pero superou o tempo de espera. A cabeceira "Retry-After" pode indicar o tempo despois do cal se pode tentar de novo a solicitude.
Conflito 409. A solicitude non se pode completar debido a un conflito co estado actual do recurso.
410 Desaparecido . O recurso solicitado existía previamente, pero agora foi eliminado e non se espera a súa restauración.
411 Lonxitude requirida . O servidor esixe especificar a lonxitude do contido na solicitude; a ausencia desta información considérase un erro.
412 Fallou a precondición . Non se cumpre unha precondición na solicitude que impide a súa execución.
413 Carga útil demasiado grande . O tamaño dos datos da solicitude supera os límites do servidor.
414 URI demasiado longo . A lonxitude do URI na solicitude supera os límites aceptables.
415 Tipo de soporte non compatible . O servidor non pode procesar o tipo de datos proporcionado na solicitude.
416 Rango non satisfactorio . Erro HTTP onde o rango solicitado non coincide cos datos actuais do servidor.
417 Fallou a expectativa . Non se cumpriu a condición esperada na cabeceira "Expect".
418 Son unha teteira . Este código inclúese como unha broma e non implica ningunha acción real para o usuario ou o servidor, e non é un erro en toda regra. Indica que o servidor é unha teteira e non é capaz de facer café.
421 Solicitude mal dirixida . O servidor non procesa a solicitude debido a un erro na solicitude ou na configuración do servidor.
422 Entidade non procesable . O servidor entende a solicitude, pero non a procesa debido a erros de datos.
423 Bloqueado. O recurso está bloqueado e non se pode procesar.
424 Dependencia fallida . A solicitude depende doutra solicitude non executada.
425 Demasiado cedo. O servidor non está listo para procesar a solicitude debido á súa chegada anticipada.
426 Actualización necesaria . O servidor require o uso dun protocolo máis avanzado para procesar a solicitude.
428 Precondición requirida . O servidor require que se especifiquen certas precondicións na solicitude.
429 Demasiadas solicitudes . O cliente enviou demasiadas solicitudes nun curto período de tempo, superando os límites do servidor.
431 Campos de cabeceira de solicitude demasiado grandes . As cabeceiras de solicitude superan o tamaño máximo permitido.
449 Reintentar con. Indica que a solicitude non pode ser executada polo servidor actual, pero que pode ser procesada correctamente por outro servidor e que o cliente debe reintentar a solicitude cun novo URI.
451 Non dispoñible por motivos legais . O recurso non está dispoñible por motivos legais.
499 Solicitude pechada do cliente . O servidor recibiu a solicitude, pero o cliente pechou a conexión antes de que se completase o procesamento.
Erro HTTP 5xx (erros do servidor)
Os códigos de erro HTTP 5xx indican os problemas do servidor. Estes códigos indican problemas que ocorreron no lado do servidor, polo que o servidor non pode procesar a solicitude do usuario dun xeito correcto. Vexámolos máis de cerca:
Erro HTTP 500 Erro interno do servidor . O servidor atopa circunstancias inesperadas que lle impiden completar a solicitude. A cabeceira "Servidor" pode indicar o servidor no que se produciu o erro.
501 Non implementado . O servidor non admite a funcionalidade necesaria para procesar a solicitude do cliente. A cabeceira "Via" pode indicar o servidor proxy a través do cal se produciu o erro.
502 Pasarela incorrecta . Este código significa que o servidor que actúa como proxy recibiu unha resposta incorrecta doutro servidor.
Erro HTTP 503. Servizo non dispoñible . O servidor non pode procesar solicitudes temporalmente.
504 Tempo de espera da pasarela . O servidor, que actúa como proxy, non recibiu unha resposta oportuna doutro servidor.
505 Versión HTTP non compatible . O servidor non admite a versión do protocolo HTTP especificada na solicitude. Como opción de reserva, a cabeceira "Actualizar" pode indicar protocolos compatibles.
A variante 506 tamén negocia . Este estado non se usa en HTTP/1.1; non obstante, se o servidor detecta unha configuración interna que provoca ambigüidade na negociación de contido, pode usar esta resposta.
507 Almacenamento insuficiente . O servidor non pode cumprir a solicitude debido a que non hai espazo de almacenamento suficiente no servidor.
508 Bucle detectado . O servidor detectou un bucle mentres procesaba a solicitude e négase a completala para evitar un bucle infinito.
509 Límite de ancho de banda superado . O erro ocorre cando se supera o ancho de banda do servidor debido a un gran volume de solicitudes ou tráfico.
510 Non ampliado . O cliente debe transferir extensións adicionais para continuar coa solicitude.
511 Autenticación de rede requirida . O cliente debe autenticarse para poder acceder á rede.
Como comprobar o código de estado da páxina
Nesta sección, teremos en conta tres formas principais de comprobar o código de estado da páxina: a través da liña de comandos, usando un navegador web e utilizando servizos en liña independentes. Cada un destes métodos ten as súas propias vantaxes e pode ser útil en diferentes situacións.
Comprobando a resposta do servidor a través da liña de comandos
A liña de comandos ofrece un xeito cómodo de comprobar o código de estado da páxina sen ter que utilizar un navegador web. Para este método, cómpre abrir a liña de comandos e usar o comando:
curl -I http://page-addressEste comando envía unha solicitude HEAD (solicitude de cabeceiras) ao URL especificado e mostra información incluíndo o código de estado HTTP:
O exemplo anterior mostra un código de resposta exitoso. No caso dunha resposta que conteña un código de erro, como o erro HTTP 404 Not Found, o resultado será semellante:
Comprobando a resposta do servidor a través da consola do navegador
A consola de desenvolvedores do navegador web ofrece ferramentas para realizar varias operacións, incluíndo a comprobación do código de estado da páxina. Para ver o código HTTP na resposta do servidor, cómpre abrir a consola do programador (Ctrl+Shift+K) ou (Ctrl+shift+J) dependendo do navegador utilizado. A continuación, seleccione a sección "rede" e cargue a páxina desexada:
Comprobación da resposta do servidor mediante ferramentas independentes
Existe unha gran cantidade de servizos en liña independentes que ofrecen ferramentas para comprobar o código de estado da páxina web. Estes servizos adoitan permitirche obter rapidamente unha visión xeral da dispoñibilidade e o rendemento do teu recurso. Todos eles funcionan co mesmo principio. Como exemplo, consideraremos o recurso máis popular: httpsstatus.io
Primeiro de todo, cómpre abrir o servizo en si, despois introducir o enderezo da páxina que resposta debes saber e solicitar a verificación:
O resultado mostrarase na parte inferior da páxina:
Conclusión
En conclusión, hai que subliñar que comprender e ser capaz de ler os códigos de erro HTTP é unha habilidade clave para calquera persoa involucrada no desenvolvemento web e mantemento do servidor. A medida que descubrimos cada erro e exploramos as ferramentas para detectalos, vemos razóns polas que é tan importante xestionar de forma eficaz estes aspectos dos servizos web.
