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.

Métodos HTTP Comunes

  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.

Comparación de Métodos HTTP

Método Idempotente Modifica el Estado Uso Común
GET No Recuperar datos
POST No Crear nuevos recursos
PUT Actualizar o crear recursos
DELETE Eliminar recursos
PATCH No Modificar parcialmente

Ejercicio Práctico

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.

Conclusión

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.

© Copyright 2024. Todos los derechos reservados