Etiqueta: fetch

  • Dejar Postman: usar CLI y scripts para pruebas de APIs

    Dejar Postman: usar CLI y scripts para pruebas de APIs

    Resumen: pasar de Postman a herramientas en terminal y scripts acelera pruebas, evita clics repetitivos y facilita la automatización. Este artículo muestra por qué y cómo hacerlo con ejemplos prácticos.

    Introducción

    Postman es útil para explorar APIs y aprender. Sin embargo, en proyectos con muchos endpoints o cuando se requiere automatización y versionado, depender de una GUI provoca trabajo manual repetitivo y menos control.

    Prerrequisitos

    Antes de reemplazar Postman por comandos y scripts, instala o confirma disponibilidad de las herramientas base y control de versiones.

    • Terminal / shell (bash).
    • curl o HTTPie para solicitudes directas.
    • Un lenguaje para scripts (en los ejemplos usamos JavaScript con fetch o axios).
    • Repositorio Git para versionar colecciones de pruebas.

    Desarrollo

    Procedimiento

    Convierte flujos manuales en comandos y scripts siguiendo pasos repetibles. La idea es minimizar clics, tener trazabilidad en Git y permitir automatización.

    1. Mapea los endpoints y los parámetros que usas en Postman.
    2. Escribe comandos curl o HTTPie para cada caso común (login, CRUD).
    3. Encapsula llamadas frecuentes en scripts (por ejemplo, en JavaScript) para validación y encadenamiento.
    4. Versiona esos scripts y ejecútalos desde CI o tareas programadas para pruebas automatizadas.

    Ejemplos

    Ejemplo básico con HTTPie (fácil de leer y cómodo en terminal).

    http POST https://api.example.com/login username=admin password=1234Lenguaje del código: Bash (bash)

    Ejemplo equivalente con curl (útil cuando necesitas control fino o integración en scripts bash).

    curl -X POST https://api.example.com/data \
      -H "Authorization: Bearer <token>" \
      -H "Content-Type: application/json" \
      -d '{"name":"Kiran","age":25}'Lenguaje del código: Bash (bash)

    Ejemplo en JavaScript para usar dentro de un repositorio (versionable y combinable con pruebas unitarias o de integración).

    const headers = {
      "Authorization": "Bearer YOUR_TOKEN",
      "Content-Type": "application/json"
    };
    const body = { name: "Kiran", role: "developer" };
    
    fetch("https://api.example.com/users", {
      method: "POST",
      headers,
      body: JSON.stringify(body)
    })
      .then(res => res.json())
      .then(data => console.log(data))
      .catch(err => console.error(err));Lenguaje del código: JavaScript (javascript)

    Ventaja práctica: encadenar llamadas, registrar respuestas y usar los scripts en CI sin intervención manual.

    Checklist

    • Convertir endpoints críticos a comandos reproducibles.
    • Guardar scripts en el repositorio con ejemplos y README.
    • Agregar ejecución automática en CI para pruebas básicas.
    • Documentar cómo obtener y rotar tokens de autorización.

    Conclusión

    Postman sigue siendo valioso para aprendizaje y exploración rápida, pero mover pruebas a CLI y scripts reduce errores humanos, mejora la velocidad y habilita automatización y trazabilidad. Empieza por convertir los flujos más repetidos y versiona las pruebas.