Herramientas · Software

Códigos de estado HTTP: referencia completa

Consulte el significado de los códigos de estado HTTP —200, 301, 404, 500 y todos los demás—, cuándo se usan y cómo reaccionar ante cada uno. Incluye los 63 códigos estándar y los no estándar más habituales (nginx, Cloudflare, Laravel y Apache), con buscador y filtro por familia.

Códigos de estado HTTP

CódigoNombreSignificadoCuándo se usa y cómo reaccionarOrigen
100Continue ContinuarEl servidor recibió los encabezados y el cliente puede enviar el cuerpo de la solicitud.Se usa con Expect: 100-continue antes de subir un cuerpo grande, para saber si el servidor lo aceptará.RFC 9110
101Switching Protocols Cambio de protocoloEl servidor acepta cambiar de protocolo a petición del cliente.Es la respuesta al abrir un WebSocket mediante el encabezado Upgrade.RFC 9110
102Processing ProcesandoEl servidor ha recibido la solicitud y aún la está procesando; evita que el cliente agote el tiempo de espera.Propio de WebDAV; está en desuso y casi no se ve.RFC 2518 (WebDAV)
103Early Hints Pistas tempranasPermite al navegador empezar a precargar recursos mientras el servidor prepara la respuesta final.Se envía con encabezados Link (rel=preload) antes del 200 para acelerar la carga de la página.RFC 8297
200OK CorrectoLa solicitud se procesó con éxito.La respuesta general de éxito: un GET devuelve el recurso; un POST, el resultado de la acción.RFC 9110
201Created CreadoSe creó un recurso nuevo como resultado de la solicitud.Respuesta típica de un POST en una API REST. Debe incluir Location con la dirección del recurso creado.RFC 9110
202Accepted AceptadoLa solicitud se aceptó, pero su procesamiento aún no ha terminado.Para trabajos asíncronos: informe de dónde consultar el estado o el resultado.RFC 9110
203Non-Authoritative Information Información no autoritativaLa respuesta es correcta, pero un intermediario (proxy) modificó la que envió el servidor de origen.Lo envía un proxy que transformó la respuesta 200 original (por ejemplo, filtrando o convirtiendo el contenido). Hoy es poco frecuente.RFC 9110
204No Content Sin contenidoLa solicitud tuvo éxito y no hay cuerpo que devolver.Habitual en DELETE y en PUT o PATCH que no devuelven el recurso. El navegador no cambia de página.RFC 9110
205Reset Content Restablecer contenidoÉxito; el cliente debe restablecer la vista (por ejemplo, vaciar un formulario).Pensado para formularios de entrada repetitiva de datos: tras enviarlo, el cliente lo vacía para el siguiente registro. Se usa muy poco.RFC 9110
206Partial Content Contenido parcialSe devuelve solo una parte del recurso, la pedida con el encabezado Range.Descargas reanudables, vídeo y audio en streaming. Incluye Content-Range.RFC 9110
207Multi-Status Estado múltipleEl cuerpo (XML) contiene varios estados, uno por cada recurso afectado.Operaciones por lotes en WebDAV (por ejemplo, PROPFIND o COPY sobre varios archivos): cada recurso trae su propio estado dentro del XML.RFC 4918 (WebDAV)
208Already Reported Ya informadoLos miembros de una colección ya se informaron en una respuesta anterior.WebDAV, dentro de un 207: señala que ese recurso ya se detalló antes en la misma respuesta, para no repetirlo ni caer en bucles.RFC 5842 (WebDAV)
226IM Used IM utilizadoEl servidor aplicó manipulaciones de instancia (por ejemplo, codificación delta) a la respuesta.Responde a una solicitud con A-IM (codificación delta) cuando el servidor devuelve solo las diferencias respecto a una versión anterior. Casi no se implementa.RFC 3229
300Multiple Choices Múltiples opcionesHay varias representaciones posibles del recurso y el cliente debe elegir.Casi no se usa; no existe una forma estándar de elegir.RFC 9110
301Moved Permanently Movido permanentementeEl recurso tiene una nueva dirección permanente, indicada en Location.Cambios de dominio o de URL. Los buscadores transfieren el posicionamiento a la nueva dirección. Los navegadores pueden convertir POST en GET; para conservar el método use 308.RFC 9110
302Found EncontradoRedirección temporal a la dirección de Location.Redirecciones provisionales. Históricamente los clientes cambian POST por GET; para conservar el método use 307.RFC 9110
303See Other Ver otroLa respuesta está en otra dirección y debe pedirse con GET.Patrón Post/Redirect/Get: tras procesar un formulario se redirige a una página de resultado, para que recargar no repita el envío.RFC 9110
304Not Modified No modificadoEl recurso no ha cambiado desde la versión que el cliente tiene en caché.Respuesta a solicitudes condicionales (If-None-Match, If-Modified-Since). No lleva cuerpo y ahorra ancho de banda.RFC 9110
305Use Proxy Usar proxyEl recurso debe pedirse a través del proxy indicado.Obsoleto por motivos de seguridad; no debe usarse.RFC 7231 (obsoleto)
306(Unused) (Sin uso)Código reservado que ya no se usa.No debe enviarse ni interpretarse: el número quedó reservado.RFC 9110
307Temporary Redirect Redirección temporalRedirección temporal que conserva el método y el cuerpo de la solicitud original.Como el 302, pero sin riesgo de que un POST se convierta en GET.RFC 9110
308Permanent Redirect Redirección permanenteRedirección permanente que conserva el método y el cuerpo.Como el 301, pero sin riesgo de que un POST se convierta en GET. Útil al mover endpoints de una API.RFC 9110
400Bad Request Solicitud incorrectaEl servidor no puede procesar la solicitud porque tiene un error del cliente: sintaxis, cuerpo mal formado o parámetros inválidos.La respuesta general de «lo enviado no es válido». Conviene explicar qué falló en el cuerpo de la respuesta.RFC 9110
401Unauthorized No autorizadoFaltan credenciales de autenticación válidas. A pesar del nombre, significa «no autenticado».Debe incluir WWW-Authenticate. Si el usuario está identificado pero no tiene permiso, la respuesta correcta es 403.RFC 9110
402Payment Required Pago requeridoReservado para uso futuro con sistemas de pago.Algunas API lo usan para indicar cuota agotada o suscripción vencida.RFC 9110
403Forbidden ProhibidoEl servidor entiende la solicitud pero se niega a cumplirla: el usuario no tiene permiso.Autenticado sin autorización. Volver a autenticarse no cambia el resultado.RFC 9110
404Not Found No encontradoEl servidor no encontró el recurso solicitado.Dirección inexistente o recurso eliminado. También se usa para ocultar que un recurso existe a quien no debe verlo.RFC 9110
405Method Not Allowed Método no permitidoEl método HTTP no está permitido para este recurso.Debe incluir Allow con los métodos admitidos. Por ejemplo, un POST a un recurso de solo lectura.RFC 9110
406Not Acceptable No aceptableEl servidor no puede producir una respuesta que cumpla los encabezados Accept del cliente.Negociación de contenido fallida (formato, idioma, codificación).RFC 9110
407Proxy Authentication Required Autenticación de proxy requeridaEl cliente debe autenticarse ante el proxy.Equivale al 401, pero para un proxy: la respuesta incluye Proxy-Authenticate y el cliente repite la solicitud con Proxy-Authorization.RFC 9110
408Request Timeout Tiempo de espera agotadoEl servidor se cansó de esperar a que el cliente terminara de enviar la solicitud.Conexión inactiva o envío muy lento. El cliente puede repetirla.RFC 9110
409Conflict ConflictoLa solicitud choca con el estado actual del recurso.Registro duplicado, edición sobre una versión desfasada o transición de estado no permitida.RFC 9110
410Gone DesaparecidoEl recurso existió, pero se eliminó de forma permanente y no hay nueva dirección.Más explícito que el 404: los buscadores retiran antes la página del índice.RFC 9110
411Length Required Longitud requeridaEl servidor exige el encabezado Content-Length.Servidores que no admiten cuerpos sin longitud conocida.RFC 9110
412Precondition Failed Precondición fallidaNo se cumple una condición de los encabezados If-Match, If-Unmodified-Since u otros.Control de concurrencia optimista: evita sobrescribir cambios ajenos.RFC 9110
413Content Too Large Contenido demasiado grandeEl cuerpo de la solicitud supera el límite del servidor. Antes se llamaba «Payload Too Large».Subida de archivos mayor al máximo configurado (por ejemplo, client_max_body_size en nginx).RFC 9110
414URI Too Long URI demasiado largaLa dirección es más larga de lo que el servidor admite.Formularios GET con demasiados datos: use POST.RFC 9110
415Unsupported Media Type Tipo de medio no soportadoEl formato del cuerpo (Content-Type) no es uno de los admitidos.Enviar XML a una API que solo acepta JSON, o JSON sin la cabecera correcta.RFC 9110
416Range Not Satisfiable Rango no satisfactorioEl rango pedido en Range queda fuera del tamaño del recurso.Reanudar una descarga más allá del final del archivo.RFC 9110
417Expectation Failed Expectativa fallidaEl servidor no puede cumplir la expectativa del encabezado Expect.Casi siempre con Expect: 100-continue.RFC 9110
418I'm a teapot Soy una teteraBroma del Protocolo de Control de Cafeteras de Hipertexto: una tetera se niega a preparar café.Un huevo de Pascua; algunos servicios lo usan para rechazar bots. El estándar actual lo reserva.RFC 2324 (1 de abril)
421Misdirected Request Solicitud mal dirigidaLa solicitud llegó a un servidor que no puede responder a ese dominio.Típico con HTTP/2 y certificados compartidos entre dominios.RFC 9110
422Unprocessable Content Contenido no procesableLa sintaxis es correcta, pero el contenido no supera la validación (errores semánticos). Antes se llamaba «Unprocessable Entity».Muy usado en API para errores de validación de campos, a diferencia del 400, que indica un cuerpo ilegible.RFC 9110
423Locked BloqueadoEl recurso está bloqueado.WebDAV: otro usuario lo bloqueó (método LOCK) y no puede modificarse hasta que se libere.RFC 4918 (WebDAV)
424Failed Dependency Dependencia fallidaLa solicitud falló porque dependía de otra que falló.WebDAV: en una operación encadenada (por ejemplo, un PROPPATCH), el resto de las órdenes fallan con 424 cuando una anterior no se pudo completar.RFC 4918 (WebDAV)
425Too Early Demasiado prontoEl servidor no quiere procesar una solicitud que podría repetirse (replay).Aparece con datos tempranos de TLS 1.3 (0-RTT).RFC 8470
426Upgrade Required Actualización requeridaEl cliente debe usar otro protocolo, indicado en Upgrade.Exigir TLS o una versión posterior de HTTP; la respuesta incluye Upgrade con los protocolos aceptados.RFC 9110
428Precondition Required Precondición requeridaEl servidor exige que la solicitud sea condicional.Obliga a enviar If-Match para evitar sobrescrituras.RFC 6585
429Too Many Requests Demasiadas solicitudesEl cliente superó el límite de peticiones (limitación de tasa).Debe incluir Retry-After. El cliente debe esperar antes de reintentar.RFC 6585
431Request Header Fields Too Large Encabezados demasiado grandesLos encabezados de la solicitud (o uno solo) son demasiado grandes.Cookies acumuladas o un token muy largo en Authorization. Borrar las cookies del sitio suele resolverlo; en el servidor, revise el límite de tamaño de los encabezados.RFC 6585
451Unavailable For Legal Reasons No disponible por razones legalesEl contenido se bloqueó por una exigencia legal.Una orden judicial o una restricción de un país. El número alude a «Fahrenheit 451».RFC 7725
500Internal Server Error Error interno del servidorEl servidor tuvo un problema inesperado y no pudo completar la solicitud.Excepción no controlada o error de configuración. Revise los registros del servidor.RFC 9110
501Not Implemented No implementadoEl servidor no admite la funcionalidad o el método pedido.Un método HTTP que el servidor no reconoce o no admite para ningún recurso (el 405, en cambio, es para un recurso concreto).RFC 9110
502Bad Gateway Puerta de enlace incorrectaUn servidor intermedio (proxy o balanceador) recibió una respuesta no válida del servidor de origen.La aplicación está caída o devolvió algo ininteligible. Revise el servicio detrás del proxy.RFC 9110
503Service Unavailable Servicio no disponibleEl servidor no puede atender la solicitud ahora: está sobrecargado o en mantenimiento.Temporal; conviene incluir Retry-After. Los buscadores entienden que deben volver más tarde.RFC 9110
504Gateway Timeout Tiempo de espera de la puerta de enlace agotadoUn servidor intermedio no recibió a tiempo la respuesta del servidor de origen.La aplicación tarda demasiado: consultas lentas o tiempos de espera del proxy demasiado cortos.RFC 9110
505HTTP Version Not Supported Versión HTTP no soportadaEl servidor no admite la versión de HTTP de la solicitud.La solicitud usa una versión de HTTP que el servidor no admite o rechaza. Muy raro en la práctica.RFC 9110
506Variant Also Negotiates La variante también negociaError de configuración en la negociación de contenido transparente.Fallo de configuración interno: la variante elegida está a su vez configurada para negociar contenido y no puede ser el punto final. Muy raro.RFC 2295
507Insufficient Storage Almacenamiento insuficienteEl servidor no tiene espacio para completar la solicitud.Disco o cuota llena: el servidor no puede guardar lo necesario para completar la solicitud (típico de WebDAV).RFC 4918 (WebDAV)
508Loop Detected Bucle detectadoEl servidor detectó un bucle infinito al procesar la solicitud.WebDAV: una operación recursiva (por ejemplo, un PROPFIND de profundidad infinita) halló enlaces circulares y se abortó.RFC 5842 (WebDAV)
510Not Extended No extendidoFaltan extensiones que la solicitud necesita.Obsoleto: lo definía el marco de extensiones de HTTP (RFC 2774), que pasó a estado histórico. No debe usarse.RFC 2774 (obsoleto)
511Network Authentication Required Autenticación de red requeridaEl cliente debe autenticarse para acceder a la red.Portales cautivos de Wi-Fi (hoteles, aeropuertos).RFC 6585
419Page Expired Página caducadaLa sesión o el token CSRF caducó.Laravel lo devuelve cuando falta o venció el token de seguridad de un formulario. Actualice la página y repita el envío.Laravel (no estándar)
444No Response Sin respuestaEl servidor cierra la conexión sin enviar ninguna respuesta.nginx lo registra para rechazar solicitudes maliciosas sin gastar recursos.nginx (no estándar)
499Client Closed Request El cliente cerró la solicitudEl cliente cerró la conexión antes de recibir la respuesta.nginx lo registra cuando el usuario cancela la página o un cliente agota su tiempo de espera.nginx (no estándar)
509Bandwidth Limit Exceeded Límite de ancho de banda excedidoEl sitio superó su transferencia mensual asignada.Alojamientos compartidos con Apache y cPanel.Apache / cPanel (no estándar)
520Web Server Returned an Unknown Error Error desconocido del servidor webEl servidor de origen devolvió una respuesta que Cloudflare no entiende o la cerró de forma inesperada.Revise el registro del servidor de origen: suele ser un fallo de la aplicación o encabezados demasiado grandes.Cloudflare (no estándar)
521Web Server Is Down Servidor web caídoEl servidor de origen rechazó la conexión de Cloudflare.El servidor o el servicio web están detenidos, o un cortafuegos bloquea a Cloudflare.Cloudflare (no estándar)
522Connection Timed Out Conexión agotadaCloudflare no pudo conectar con el servidor de origen a tiempo.Servidor saturado, apagado o con el cortafuegos bloqueando las IP de Cloudflare.Cloudflare (no estándar)
523Origin Is Unreachable Origen inalcanzableCloudflare no encuentra una ruta hasta el servidor de origen.Registro DNS incorrecto o problema de red del origen.Cloudflare (no estándar)
524A Timeout Occurred Se agotó el tiempo de esperaCloudflare conectó con el origen, pero este no respondió dentro del tiempo máximo (del orden de 100 a 125 segundos por omisión; solo el plan Enterprise puede ampliarlo).Procesos largos, como exportaciones o consultas pesadas: muévalos a una cola o a una tarea en segundo plano.Cloudflare (no estándar)
525SSL Handshake Failed Fallo en el protocolo TLSCloudflare no pudo completar la negociación TLS con el origen.Certificado o configuración TLS del origen incompatibles.Cloudflare (no estándar)
526Invalid SSL Certificate Certificado SSL no válidoCloudflare no pudo validar el certificado del servidor de origen.Certificado caducado, autofirmado o de otro dominio, con el modo SSL estricto.Cloudflare (no estándar)
530Origin DNS Error Error de DNS del origenCloudflare no pudo resolver el nombre del servidor de origen. Se devuelve junto con un error 1xxx en la página (por ejemplo, el 1016) que indica la causa concreta.Compruebe los registros DNS del dominio y que el nombre del origen exista y apunte a una dirección válida.Cloudflare (no estándar)

Esta referencia resume el estándar HTTP (RFC 9110 y los RFC que lo complementan) y la documentación de nginx, Cloudflare, Laravel y Apache. Los códigos no estándar pueden variar según la versión del servicio: confirme los detalles en su documentación oficial. Consulte los Términos de uso.

Qué es un código de estado HTTP

Cada vez que un navegador, una aplicación o un script pide algo a un servidor web, la respuesta empieza con un número de tres cifras: el código de estado. Resume lo ocurrido: 200 significa que todo fue bien, 404 que el recurso no existe y 500 que el servidor falló. Los define el estándar HTTP (RFC 9110) y el registro de IANA, y sirven tanto a las personas que depuran un problema como a los programas, que deciden con ellos si reintentar, redirigir, mostrar un error o dar por buena la respuesta.

La primera cifra indica la familia, y es lo primero que conviene mirar. El texto que acompaña al número («Not Found») es solo una explicación para humanos: lo que cuenta es el código.

Cómo usar la referencia

  1. Escriba en el buscador un código (429), el comienzo de uno (40 muestra del 400 al 409) o una familia (5xx); también una palabra (redirección, caché, tiempo de espera) o el nombre de un servicio (Cloudflare, nginx).
  2. Use los botones de familia para ver solo los errores del cliente (4xx), los del servidor (5xx), las redirecciones (3xx), etc.
  3. Pulse el número de un código para obtener un enlace directo a su fila (por ejemplo, #c404), útil para compartirlo en un informe o una conversación.
  4. Lea la columna «Cuándo se usa y cómo reaccionar»: explica el caso típico y qué hacer, tanto si usted consume una API como si la diseña.

Las cinco familias

FamiliaSignificaQuién tiene que actuarEjemplos
1xx InformativosLa solicitud se recibió y el proceso continúa.Normalmente nadie: los gestiona el navegador o la biblioteca HTTP.100, 101, 103
2xx ÉxitoLa solicitud se recibió, se entendió y se aceptó.Nadie: todo fue bien.200, 201, 204
3xx RedirecciónHace falta otra acción, normalmente ir a otra dirección.El cliente: seguir la redirección (Location) o usar la copia en caché.301, 302, 304, 308
4xx Error del clienteLa solicitud tiene un problema: es incorrecta, no autorizada o apunta a algo que no existe.Quien envía la solicitud: corregirla. Repetirla igual da el mismo error.400, 401, 403, 404, 429
5xx Error del servidorLa solicitud era válida, pero el servidor no pudo atenderla.Quien opera el servidor: investigar. El cliente puede reintentar más tarde.500, 502, 503, 504

Qué código devolver en una API

Elegir bien el código evita que quien consume su API tenga que adivinar. Estas son las decisiones que más se discuten:

SituaciónCódigoPor qué
Se crea un recurso con POST201 Created, con LocationDistingue «creado» de «correcto» y dice dónde está.
Se acepta un trabajo que se hará después202 AcceptedEl resultado aún no existe; indique cómo consultarlo.
Se borra o se actualiza sin devolver nada204 No ContentÉxito sin cuerpo: ahorra bytes y ambigüedades.
El JSON enviado está mal formado400 Bad RequestNo se pudo ni leer.
El JSON es correcto, pero un campo no es válido422 Unprocessable ContentError de validación semántica (correo sin «@», edad negativa).
No hay credenciales o son inválidas401 UnauthorizedSignifica «no autenticado»: el cliente debe identificarse.
Está identificado, pero no tiene permiso403 ForbiddenAutenticarse otra vez no ayuda.
El recurso no existe (o no debe saberse que existe)404 Not FoundTambién para ocultar recursos privados a quien no debe verlos.
Se eliminó para siempre410 GoneMás preciso que 404 para contenido retirado.
Duplicado, o edición sobre una versión vieja409 ConflictEl estado actual impide la operación.
Demasiadas peticiones429 Too Many Requests, con Retry-AfterLimitación de tasa: dice cuánto esperar.
Fallo inesperado del servidor500 Internal Server ErrorSin detalles internos en la respuesta: regístrelos en el servidor.
Mantenimiento o sobrecarga503 Service Unavailable, con Retry-AfterTemporal: los clientes y los buscadores vuelven a intentarlo.

Códigos habituales por método HTTP

MétodoÉxitoErrores frecuentes
GET (leer)200 (con el recurso), 206 (parcial), 304 (sin cambios)400, 401, 403, 404, 410, 429
POST (crear o ejecutar)201 (creado), 202 (aceptado), 200 o 204400, 401, 403, 409, 415, 422, 429
PUT (reemplazar)200 o 204; 201 si lo crea400, 404, 409, 412, 415, 422
PATCH (modificar en parte)200 o 204400, 404, 409, 412, 415, 422
DELETE (borrar)204 (o 200 con un mensaje); 202 si se borra después401, 403, 404, 409
HEAD y OPTIONS200 o 204405 si no se permite

Las redirecciones: 301, 302, 303, 307 y 308

Son las más confundidas. Se distinguen por dos preguntas: ¿el cambio es permanente? y ¿se conserva el método (POST, PUT…) y el cuerpo?

CódigoPermanenteConserva el métodoÚselo para
301 Moved PermanentlySíNo siempre (un POST puede pasar a GET)Cambios de dominio o de dirección de páginas web.
308 Permanent RedirectSíSíMover de forma permanente un endpoint de una API.
302 FoundNoNo siempre (un POST puede pasar a GET)Redirecciones temporales de páginas, de uso general.
307 Temporary RedirectNoSíRedirección temporal de una API sin alterar el método.
303 See OtherNoSiempre cambia a GETDespués de un POST: llevar al usuario a una página de resultado (Post/Redirect/Get).

Para el posicionamiento en buscadores, una redirección permanente (301 o 308) indica que la nueva dirección sustituye a la antigua; una temporal (302 o 307) indica que la antigua sigue siendo la válida. Evite las cadenas largas de redirecciones: cada salto añade latencia, y los navegadores y rastreadores abandonan tras unos pocos.

Encabezados que acompañan a cada código

CódigoEncabezadoPara qué
201, 301, 302, 303, 307, 308LocationLa dirección del recurso creado o a la que se redirige.
401WWW-AuthenticateCómo debe autenticarse el cliente (Bearer, Basic…).
405AllowLos métodos que sí admite el recurso.
429, 503Retry-AfterCuántos segundos esperar, o a partir de qué fecha reintentar.
206Content-RangeQué parte del recurso contiene la respuesta.
304ETag, Cache-ControlLos validadores de la caché que justifican la respuesta sin cuerpo.
4xx, 5xxContent-Type: application/problem+jsonUn formato estándar (RFC 9457) para describir errores en las API.

Distinguir los errores 500, 502, 503 y 504

CódigoQué indicaDónde mirar
500La aplicación falló al procesar la solicitud.Los registros de la aplicación: excepciones, configuración, base de datos.
502El proxy o balanceador recibió una respuesta inválida (o ninguna) de la aplicación.Que la aplicación esté en marcha y escuche en el puerto correcto; fallos al arrancar.
503El servicio no puede atender ahora: sobrecarga o mantenimiento.Capacidad, límites de conexiones, modo de mantenimiento.
504El proxy esperó demasiado la respuesta de la aplicación.Consultas lentas, procesos largos y los tiempos de espera del proxy (proxy_read_timeout en nginx).

Con Cloudflare, los errores 520 a 526 son más específicos: indican dónde falló la conexión entre Cloudflare y su servidor de origen (conexión rechazada, tiempo agotado, certificado inválido, etc.). Están en la tabla, con la causa más probable de cada uno.

Buenas prácticas

  • No devuelva 200 con un error en el cuerpo. Los clientes, las cachés y las herramientas de monitoreo se fían del código: si todo es 200, nadie se entera de que algo falló.
  • Incluya un mensaje útil en los errores 4xx (qué campo falló y por qué), sin revelar detalles internos como rutas o trazas.
  • Use 401 y 403 con precisión: el primero pide identificarse; el segundo, que quien está identificado no tiene permiso.
  • Reintente solo lo que se puede reintentar: los 429, 503 y 504 (con espera, respetando Retry-After) y las operaciones idempotentes. Un 4xx no se arregla reintentando.
  • Cuide las páginas de error. Una página 404 con enlaces útiles y un código 404 real (no un 200 «blando») es mejor para las personas y para los buscadores.

Si trabaja con tokens en las cabeceras de autenticación, vea el decodificador JWT; para los datos que viajan en el cuerpo de las respuestas, el validador JSON.

Preguntas frecuentes

¿Cuál es la diferencia entre 401 y 403?

El 401 significa «no autenticado»: faltan credenciales válidas, y el cliente puede volver a intentarlo identificándose. El 403 significa «prohibido»: el servidor sabe quién es el usuario, pero no tiene permiso, de modo que identificarse de nuevo no cambia nada.

¿Cuándo uso 301 y cuándo 302?

Use 301 (o 308) cuando el cambio de dirección es permanente: los buscadores transfieren el posicionamiento a la nueva URL. Use 302 (o 307) cuando es temporal y la dirección original seguirá siendo la válida. Si redirige solicitudes POST y quiere conservar el método, elija 307 o 308.

¿Qué significa un error 502 Bad Gateway?

Que un servidor intermedio (proxy, balanceador o CDN) pidió la respuesta a la aplicación y recibió algo inválido o nada. Casi siempre la aplicación está caída, se reinició o no escucha donde el proxy espera.

¿Qué diferencia hay entre 400 y 422?

El 400 indica que la solicitud no se pudo interpretar (JSON mal formado, parámetros ilegibles). El 422 indica que se entendió perfectamente, pero su contenido no pasa la validación (un correo sin formato válido, un valor fuera de rango).

¿Qué es un error 429?

Too Many Requests: el cliente superó el límite de peticiones permitido. La respuesta debería incluir Retry-After con el tiempo de espera, y el cliente debe respetarlo antes de reintentar.

¿Qué significa 418 «Soy una tetera»?

Es una broma del RFC 2324 (el protocolo de control de cafeteras, publicado un 1 de abril): una tetera se niega a preparar café. No tiene uso real, aunque algunos servicios lo devuelven como huevo de Pascua o para rechazar bots.

¿Son oficiales los códigos de Cloudflare como 522 o 524?

No: están fuera del estándar. Los define Cloudflare para explicar qué falló entre su red y su servidor de origen. Lo mismo ocurre con el 499 y el 444 de nginx o el 419 de Laravel; la tabla los marca como «No estándar».