Buscador de Códigos de Estado HTTP
Referencia completa de códigos de estado HTTP. Busca el significado de cualquier código de estado, comprende los códigos de respuesta y aprende sobre códigos de error HTTP.
Continue
The server has received the request headers and the client should proceed to send the request body.
Switching Protocols
The requester has asked the server to switch protocols and the server has agreed.
Processing
A WebDAV request may contain many sub-requests involving file operations, requiring a long time to complete the request.
Early Hints
Used to return some response headers before final HTTP message.
OK
The request is successful. The meaning of success depends on the HTTP method used.
Created
The request has been fulfilled and a new resource has been created.
Accepted
The request has been accepted for processing, but the processing has not been completed.
Non-Authoritative Information
The request was successful but the information may have been modified by a transforming proxy.
No Content
The server successfully processed the request but is not returning any content.
Reset Content
The server successfully processed the request but is not returning any content and requires the requester to reset the document view.
Partial Content
The server is delivering only part of the resource due to a range header sent by the client.
Multi-Status
Provides status for multiple independent operations.
Already Reported
The members of a DAV binding have already been enumerated in a preceding part of the multistatus response.
IM Used
The server has fulfilled a GET request for the resource, and the response is a representation of the result of one or more instance-manipulations applied to the current instance.
Multiple Choices
The request has more than one possible response. The user agent should choose one of them.
Moved Permanently
The URL of the requested resource has been changed permanently. The new URL is given in the response.
Found
The URL of the requested resource has been changed temporarily. Further changes in the URL might be made in the future.
See Other
The server sent this response to direct the client to get the requested resource at another URI with a GET request.
Not Modified
Used for caching purposes. The client can use cached version of the response.
Use Proxy
The requested resource is available only through a proxy.
Unused
This response code is no longer used and is reserved.
Temporary Redirect
The server sends this response to direct the client to get the requested resource at another URI with the same method.
Permanent Redirect
This means the resource is now permanently located at another URI.
Bad Request
The server could not understand the request due to invalid syntax.
Unauthorized
Authentication is required and has failed or has not yet been provided.
Payment Required
This response code is reserved for future use and was originally created for digital payment systems.
Forbidden
The client does not have access rights to the content; the server is refusing to give the requested resource.
Not Found
The server can not find the requested resource. This is the most common error on the internet.
Method Not Allowed
The request method is known by the server but is not supported by the target resource.
Not Acceptable
The server cannot produce a response matching the list of acceptable values defined in the request's headers.
Proxy Authentication Required
This is similar to 401 but authentication is required to be done by a proxy.
Request Timeout
The server timed out waiting for the request. The client did not produce a request within the time the server was prepared to wait.
Conflict
This response is sent when a request conflicts with the current state of the server.
Gone
The requested content has been permanently deleted from the server with no forwarding address.
Length Required
The server rejects the request because the Content-Length header field is not defined and the server requires it.
Precondition Failed
The client has indicated preconditions in its headers which the server does not meet.
Payload Too Large
The request entity is larger than limits defined by the server.
URI Too Long
The URI requested by the client is longer than the server is willing to interpret.
Unsupported Media Type
The media format of the requested data is not supported by the server.
Range Not Satisfiable
The range specified by the Range header field in the request cannot be fulfilled.
Expectation Failed
The expectation indicated by the Expect request header field cannot be met by the server.
I'm a teapot
This code was defined in 1998 as one of the traditional IETF April Fools' jokes.
Misdirected Request
The request was directed at a server that is not able to produce a response.
Unprocessable Entity
The request was well-formed but was unable to be followed due to semantic errors.
Locked
The resource that is being accessed is locked.
Failed Dependency
The request failed because it depended on another request and that request failed.
Too Early
Indicates that the server is unwilling to risk processing a request that might be replayed.
Upgrade Required
The server refuses to perform the request using the current protocol.
Precondition Required
The origin server requires the request to be conditional.
Too Many Requests
The user has sent too many requests in a given amount of time.
Request Header Fields Too Large
The server is unwilling to process the request because its header fields are too large.
Unavailable For Legal Reasons
The server is denying access to the resource as a consequence of a legal demand.
Internal Server Error
The server has encountered a situation it does not know how to handle.
Not Implemented
The request method is not supported by the server and cannot be handled.
Bad Gateway
The server, while acting as a gateway or proxy, received an invalid response from an upstream server.
Service Unavailable
The server is not ready to handle the request. Common causes are a server that is down for maintenance or is overloaded.
Gateway Timeout
The server was acting as a gateway or proxy and did not receive a timely response from the upstream server.
HTTP Version Not Supported
The HTTP version used in the request is not supported by the server.
Variant Also Negotiates
The server has an internal configuration error.
Insufficient Storage
The method could not be performed on the resource because the server is unable to store the representation needed to successfully complete the request.
Loop Detected
The server detected an infinite loop while processing the request.
Not Extended
Further extensions to the request are required for the server to fulfill it.
Network Authentication Required
The client needs to authenticate to gain network access.
Cómo Usar el Buscador de Códigos de Estado HTTP
Nuestra herramienta de búsqueda de códigos de estado HTTP proporciona una referencia completa para todos los códigos de estado HTTP. Úsala para encontrar rápidamente información sobre cualquier código de estado:
- Busca códigos de estado ingresando un número de código (como '404'), nombre de estado (como 'not found'), o palabras clave de descripción
- Filtra por categoría usando los botones de categoría para ver solo códigos informativos, de éxito, de redirección, de error del cliente o de error del servidor
- Haz clic en cualquier tarjeta de código de estado para expandir y ver información detallada incluyendo descripción, casos de uso comunes y referencia RFC
- Usa el botón de copiar para copiar códigos de estado para usar en documentación, comentarios de código o especificaciones de API
For more developer tools, check out our Toolbox homepage or explore related tools like our JSON Formatter and Hash Generator for API development workflows.
¿Qué son los Códigos de Estado HTTP?
La búsqueda de códigos de estado HTTP es esencial para desarrolladores web, diseñadores de API y cualquiera que trabaje con tecnologías web. Los códigos de estado HTTP son números de tres dígitos devueltos por servidores web para indicar el resultado de una solicitud HTTP. Estos códigos proporcionan información crítica sobre si una solicitud fue exitosa, si ocurrió un error, o si se necesita una acción adicional.
Cuando visitas un sitio web o realizas una llamada API, el servidor responde con un código de estado HTTP junto con el recurso solicitado o un mensaje de error. Los códigos de estado se agrupan en cinco categorías principales según su primer dígito: respuestas informativas (1xx), respuestas exitosas (2xx), redirecciones (3xx), errores del cliente (4xx) y errores del servidor (5xx). Comprender estos códigos ayuda a los desarrolladores a depurar problemas, implementar un manejo adecuado de errores y crear mejores experiencias de usuario.
Conocer los códigos de estado HTTP es crucial para construir aplicaciones web y API robustas. El uso adecuado de códigos de estado mejora el manejo de errores, permite una mejor depuración, mejora la documentación de API y ayuda a crear mensajes de error más intuitivos para los usuarios finales. Nuestra herramienta de búsqueda de códigos de estado HTTP proporciona una referencia completa para todos los códigos de estado estándar y extendidos.
The official HTTP status code specifications are defined in RFC 7231 and related RFC documents maintained by the Internet Engineering Task Force (IETF). For comprehensive documentation, refer to the MDN HTTP Status Codes reference.
Categorías de Códigos de Estado HTTP
Los códigos de estado HTTP se organizan en cinco categorías principales. Cada categoría sirve un propósito específico en la comunicación HTTP:
1xx Informational Responses
Las respuestas informativas (100-199) indican que la solicitud fue recibida y el proceso continúa. Estas son respuestas provisionales utilizadas durante la fase de procesamiento de la solicitud. Los ejemplos incluyen 100 Continue, que le dice al cliente que continúe enviando el cuerpo de la solicitud, y 101 Switching Protocols, utilizado al actualizar a un protocolo diferente como WebSocket.
2xx Success Responses
Las respuestas de éxito (200-299) indican que la solicitud fue recibida, entendida y aceptada exitosamente. El código de éxito más común es 200 OK, que significa que la solicitud tuvo éxito. Otros códigos de éxito importantes incluyen 201 Created (para creación de recursos), 204 No Content (para operaciones exitosas sin cuerpo de respuesta) y 206 Partial Content (para solicitudes de rango en descargas de archivos).
3xx Redirection Responses
Las respuestas de redirección (300-399) indican que se necesita una acción adicional para completar la solicitud. Estos códigos se usan cuando un recurso se ha movido o cuando se deben usar ubicaciones alternativas. Los códigos de redirección comunes incluyen 301 Moved Permanently (para cambios permanentes de URL y SEO), 302 Found (redirección temporal) y 304 Not Modified (para optimización de caché).
4xx Client Error Responses
Las respuestas de error del cliente (400-499) indican que hubo un error con la solicitud. Estos errores son responsabilidad del cliente, lo que significa que la solicitud estaba mal formada, no autorizada o el recurso solicitado no existe. El error del cliente más famoso es 404 Not Found. Otros códigos importantes incluyen 400 Bad Request (sintaxis inválida), 401 Unauthorized (autenticación requerida), 403 Forbidden (permiso denegado) y 429 Too Many Requests (limitación de velocidad).
5xx Server Error Responses
Las respuestas de error del servidor (500-599) indican que el servidor no pudo cumplir con una solicitud válida. Estos errores son responsabilidad del servidor y a menudo indican problemas con la configuración del servidor, la base de datos o la lógica de la aplicación. Los errores comunes del servidor incluyen 500 Internal Server Error (fallo genérico del servidor), 502 Bad Gateway (respuesta inválida del servidor ascendente), 503 Service Unavailable (servidor temporalmente inactivo) y 504 Gateway Timeout (tiempo de espera del servidor ascendente).
Códigos de Estado HTTP Más Comunes Explicados
Aunque hay docenas de códigos de estado HTTP, ciertos códigos se encuentran con más frecuencia en el desarrollo web. Comprender estos códigos comunes es esencial para una depuración y manejo de errores efectivos:
200 OK
200 OK es la respuesta de éxito estándar para solicitudes HTTP. Indica que la solicitud tuvo éxito y la respuesta contiene el recurso solicitado. Este es el código de estado más común que encontrarás en llamadas API exitosas y cargas de páginas web. El cuerpo de la respuesta típicamente contiene los datos solicitados, HTML, JSON u otros tipos de contenido.
201 Created
201 Created indica que un nuevo recurso fue creado exitosamente como resultado de la solicitud. Este código se usa típicamente en respuesta a solicitudes POST que crean nuevos recursos. La respuesta usualmente incluye un encabezado Location que apunta al recurso recién creado. Esta es una práctica estándar en el diseño de API RESTful para endpoints de creación de recursos.
301 Moved Permanently
301 Moved Permanently indica que el recurso solicitado se ha movido permanentemente a una nueva URL. Esto es crucial para SEO, ya que los motores de búsqueda actualizarán sus índices para apuntar a la nueva ubicación. Al implementar redirecciones 301, siempre asegúrate de que la nueva URL sea correcta, ya que los navegadores y motores de búsqueda almacenarán esta redirección permanentemente. Usa esto para cambios permanentes de URL, migraciones de dominio o al consolidar contenido duplicado.
404 Not Found
404 Not Found es quizás el código de estado HTTP más reconocible. Indica que el servidor no puede encontrar el recurso solicitado. Esto no significa que el recurso se haya ido permanentemente (eso sería 410 Gone), sino que no existe en la ubicación especificada. Las causas comunes incluyen enlaces rotos, páginas eliminadas, URLs incorrectas o archivos faltantes. Al implementar páginas de error, siempre proporciona opciones de navegación útiles y funcionalidad de búsqueda para ayudar a los usuarios a encontrar lo que buscan.
500 Internal Server Error
500 Internal Server Error es un error genérico del servidor que indica que algo salió mal en el lado del servidor, pero el servidor no pudo ser más específico sobre cuál era el problema. Este código debe usarse cuando ocurrió una condición inesperada que impidió que el servidor cumpliera la solicitud. Es importante registrar estos errores en el servidor para fines de depuración, ya que indican problemas que deben abordarse en el código de la aplicación o la configuración del servidor.
Códigos de Estado HTTP en el Desarrollo de API
El uso adecuado de códigos de estado HTTP es fundamental para construir API REST bien diseñadas. Los códigos de estado comunican el resultado de las operaciones de API de manera clara y consistente, haciendo que las API sean más fáciles de entender e integrar:
- Consistencia: Usar códigos de estado apropiados consistentemente en tu API ayuda a los desarrolladores a entender e integrar con tu API más fácilmente. Sigue las convenciones REST y los estándares HTTP para asegurar un comportamiento predecible.
- Manejo de Errores: Diferentes códigos de estado ayudan a las aplicaciones cliente a manejar errores apropiadamente. Los errores 4xx indican problemas del lado del cliente que el cliente puede potencialmente corregir (como entrada inválida), mientras que los errores 5xx indican problemas del lado del servidor que requieren intervención del servidor.
- Documentación: Documentar qué códigos de estado pueden devolver tus endpoints de API ayuda a los desarrolladores a implementar un manejo adecuado de errores. Incluye códigos de estado en tu documentación de API, especificaciones OpenAPI y ejemplos de código.
- Experiencia del Cliente: Los códigos de estado bien elegidos mejoran la experiencia del cliente al proporcionar información clara y accionable. Por ejemplo, una respuesta 429 Too Many Requests con un encabezado Retry-After da a los clientes orientación específica sobre cuándo reintentar su solicitud.
Mejores Prácticas para Códigos de Estado HTTP
Seguir las mejores prácticas para códigos de estado HTTP mejora la confiabilidad, mantenibilidad y usabilidad de aplicaciones web y API:
- Elige Códigos Apropiados: Selecciona códigos de estado que reflejen con precisión el resultado de la solicitud. No uses 200 OK para condiciones de error o 500 para errores del cliente. Usa el código más específico que describa con precisión la situación.
- Proporciona Detalles de Error: Al devolver códigos de estado de error (4xx, 5xx), incluye mensajes de error detallados en el cuerpo de la respuesta. Esto ayuda a los desarrolladores a depurar problemas y proporciona mejores capacidades de manejo de errores. Incluye códigos de error, descripciones y potencialmente soluciones sugeridas.
- Registro y Monitoreo: Registra todos los códigos de estado no 2xx para fines de monitoreo y depuración. Rastrea tasas de error, identifica patrones y configura alertas para picos de error inusuales. Esto ayuda a identificar problemas antes de que impacten significativamente a los usuarios.
- Monitoreo: Usa el monitoreo de códigos de estado para rastrear la salud de la aplicación. Las altas tasas de errores 5xx indican problemas del servidor, mientras que las altas tasas de errores 4xx pueden indicar problemas del lado del cliente, mal uso de API o problemas de documentación que necesitan atención.
Solución de Problemas Comunes de Códigos de Estado
Comprender cómo solucionar problemas basados en códigos de estado HTTP es una habilidad esencial para desarrolladores web y administradores de sistemas:
Errores del Cliente (4xx): Al encontrar errores 4xx, verifica el formato de la solicitud, las credenciales de autenticación, los permisos de autorización y si el recurso solicitado existe. Revisa los encabezados de solicitud, los parámetros de consulta y el formato del cuerpo de la solicitud. Las correcciones comunes incluyen corregir URLs, proporcionar autenticación adecuada, corregir la sintaxis de la solicitud y asegurar que los recursos existan.
Para 400 Bad Request, valida los datos de entrada y verifica el formato de la solicitud. Para 401 Unauthorized, verifica los tokens de autenticación o credenciales. Para 403 Forbidden, verifica los permisos del usuario y las reglas de autorización. Para 404 Not Found, verifica la URL del recurso y su existencia. Para 429 Too Many Requests, implementa limitación de velocidad o espera antes de reintentar.
Errores del Servidor (5xx): Los errores 5xx indican problemas del lado del servidor que requieren investigación. Verifica los registros del servidor, la conectividad de la base de datos, el código de la aplicación, la configuración del servidor y los recursos del sistema. Estos errores típicamente requieren intervención del desarrollador o administrador del sistema para resolverse.
Para 500 Internal Server Error, verifica los registros de la aplicación en busca de excepciones, verifica las conexiones de la base de datos y revisa los cambios recientes en el código. Para 502 Bad Gateway, verifica la salud del servidor ascendente y la configuración del proxy. Para 503 Service Unavailable, verifica la capacidad del servidor, verifica operaciones de mantenimiento y revisa las restricciones de recursos. Para 504 Gateway Timeout, verifica los tiempos de respuesta del servidor ascendente y las configuraciones de tiempo de espera.