Una API REST es una interfaz que permite la comunicación entre diferentes sistemas o aplicaciones a través de Internet. Cuando un cliente hace una petición a una API REST, el servidor devuelve una respuesta con un código de estado HTTP, que indica el resultado de la operación solicitada.
Los códigos de estado HTTP se dividen en cinco clases, que se indican mediante el primer dígito del código:
- 1xx: respuestas informativas
- 2xx: respuestas satisfactorias
- 3xx: redirecciones
- 4xx: errores del cliente
- 5xx: errores del servidor
A continuación, te explicaré los códigos de respuesta más comunes en una API REST:
Respuestas informativas (1xx)
Los códigos de respuesta 1xx indican que la petición ha sido recibida y el servidor está procesando la petición. Estos códigos son informativos y no suelen ser utilizados en una API REST.
Respuestas satisfactorias (2xx)
Los códigos de respuesta 2xx indican que la petición ha sido recibida, comprendida y aceptada por el servidor. Los códigos más comunes son:
- 200 OK: la petición ha sido procesada con éxito.
- 201 Created: se ha creado un nuevo recurso en el servidor.
- 204 No Content: la petición ha sido procesada con éxito, pero no hay contenido que devolver.
Redirecciones (3xx)
Los códigos de respuesta 3xx indican que el servidor necesita más información para completar la petición. Los códigos más comunes son:
- 301 Moved Permanently: la URL ha sido redirigida de forma permanente a otra dirección.
- 302 Found: la URL ha sido redirigida temporalmente a otra dirección.
- 304 Not Modified: el recurso no ha sido modificado desde la última vez que fue accedido.
Errores del cliente (4xx)
Los códigos de respuesta 4xx indican que ha habido un error en la petición del cliente. Los códigos más comunes son:
- 400 Bad Request: la petición no ha podido ser entendida o tiene un formato incorrecto.
- 401 Unauthorized: el cliente no está autorizado a acceder al recurso.
- 403 Forbidden: el cliente no tiene permisos para acceder al recurso.
- 404 Not Found: el recurso solicitado no ha sido encontrado.
Errores del servidor (5xx)
Los códigos de respuesta 5xx indican que ha habido un error en el servidor al procesar la petición del cliente. Los códigos más comunes son:
- 500 Internal Server Error: el servidor ha encontrado un error interno y no ha podido completar la petición.
- 502 Bad Gateway: el servidor está actuando como proxy o gateway y ha recibido una respuesta inválida del servidor upstream.
- 503 Service Unavailable: el servidor no está disponible en este momento debido a una sobrecarga o mantenimiento.
En resumen, los códigos de respuesta en una API REST son muy importantes para entender el estado de una petición y saber si se ha procesado con éxito o ha habido algún error. Es importante que los desarrolladores implementen los códigos de respuesta adecuados en sus API para facilitar la depuración de errores y el buen manejo de los datos.
0 Comentarios