En esta sección, exploraremos los métodos HTTP, que son fundamentales para interactuar con las APIs. Los métodos HTTP definen las acciones que se pueden realizar en los recursos de una API. A continuación, desglosaremos los métodos más comunes y su uso.

1. GET

   • Descripción: Recupera datos de un servidor.
   • Uso Común: Obtener información de un recurso específico.
   • Ejemplo: Obtener detalles de un usuario.
   • Código de Ejemplo:

     GET /users/123 HTTP/1.1
     Host: api.ejemplo.com
     

   • Nota: Las solicitudes GET no deben modificar el estado del recurso.

2. POST

   • Descripción: Envía datos al servidor para crear un nuevo recurso.
   • Uso Común: Crear un nuevo registro en la base de datos.
   • Ejemplo: Crear un nuevo usuario.
   • Código de Ejemplo:

     POST /users HTTP/1.1
     Host: api.ejemplo.com
     Content-Type: application/json
     
     {
       "nombre": "Juan",
       "email": "[email protected]"
     }
     

   • Nota: Las solicitudes POST pueden cambiar el estado del servidor.

3. PUT

   • Descripción: Actualiza un recurso existente o crea uno nuevo si no existe.
   • Uso Común: Actualizar información de un usuario.
   • Ejemplo: Actualizar el correo electrónico de un usuario.
   • Código de Ejemplo:

     PUT /users/123 HTTP/1.1
     Host: api.ejemplo.com
     Content-Type: application/json
     
     {
       "email": "[email protected]"
     }
     

   • Nota: Las solicitudes PUT son idempotentes, lo que significa que realizar la misma solicitud varias veces tendrá el mismo efecto que hacerlo una sola vez.

4. DELETE

   • Descripción: Elimina un recurso del servidor.
   • Uso Común: Borrar un usuario.
   • Ejemplo: Eliminar un usuario específico.
   • Código de Ejemplo:

     DELETE /users/123 HTTP/1.1
     Host: api.ejemplo.com
     

   • Nota: Las solicitudes DELETE también son idempotentes.

5. PATCH

   • Descripción: Aplica modificaciones parciales a un recurso.
   • Uso Común: Actualizar parcialmente un recurso.
   • Ejemplo: Cambiar solo el nombre de un usuario.
   • Código de Ejemplo:

     PATCH /users/123 HTTP/1.1
     Host: api.ejemplo.com
     Content-Type: application/json
     
     {
       "nombre": "Carlos"
     }
     

   • Nota: PATCH es útil para actualizaciones parciales, a diferencia de PUT que reemplaza el recurso completo.

Ejercicio: Imagina que estás desarrollando una API para una aplicación de gestión de tareas. Define qué método HTTP usarías para las siguientes acciones y por qué:

1. Obtener la lista de todas las tareas.
2. Añadir una nueva tarea.
3. Actualizar el estado de una tarea existente.
4. Eliminar una tarea completada.

Soluciones:

1. Obtener la lista de todas las tareas: Usarías el método GET porque estás recuperando datos sin modificar el estado del servidor.
2. Añadir una nueva tarea: Usarías el método POST ya que estás creando un nuevo recurso en el servidor.
3. Actualizar el estado de una tarea existente: Usarías el método PATCH si solo estás cambiando el estado, o PUT si estás reemplazando toda la información de la tarea.
4. Eliminar una tarea completada: Usarías el método DELETE porque estás eliminando un recurso del servidor.

Comprender los métodos HTTP es esencial para interactuar eficazmente con las APIs. Cada método tiene un propósito específico y se utiliza en diferentes escenarios para manipular recursos en un servidor. En la próxima sección, exploraremos cómo utilizar Postman para realizar solicitudes HTTP y probar APIs.