Una API, o interfaz de programación de aplicaciones, permite que un programa interactúe con otro según reglas acordadas. Define qué se puede solicitar al sistema, qué datos deben proporcionarse, qué devuelve y cómo representa los errores.
Para QA, es una capa fundamental del producto. Los usuarios ven pantallas, botones y formularios, pero la lógica real suele ejecutarse más abajo: solicitudes, controles de permisos, cálculos, integraciones y cambios de datos. Quien no comprende las API casi siempre ve solo la superficie.
Cómo funciona
En un escenario típico, un cliente envía una solicitud a un servicio y este devuelve una respuesta. El cliente puede ser un navegador, una aplicación móvil, otro servicio o un socio externo. El servicio recibe la solicitud, valida datos, comprueba permisos, ejecuta lógica de negocio y devuelve el resultado.
- →Adónde va la solicitud: un endpoint o una ruta de recurso.
- →Qué ocurre: un método como GET, POST, PATCH o DELETE.
- →Qué acompaña a la solicitud: encabezados, parámetros, cuerpo y autorización.
- →Qué regresa: estado, encabezados, datos o una descripción del error.
Una API es más que «una URL y JSON». Es un contrato de interacción entre sistemas. La implementación interna de un servicio puede cambiar mientras el contrato permanece intacto.
Qué importa a QA
Las API permiten probar un sistema sin una capa visual adicional. Así, las pruebas son más rápidas, precisas y útiles para investigar.
- →Una API revela qué datos se enviaron y devolvieron realmente.
- →Es más fácil probar la lógica de negocio mediante una API que mediante la UI.
- →Las API facilitan la construcción de escenarios negativos y casos extremos.
- →Las API ayudan a identificar si el problema está en la interfaz, el backend, la autorización, los datos o la integración.
Una buena comprobación de API exige más que llamar a un endpoint. QA debe comprender los campos obligatorios, roles permitidos, comportamiento con entradas inválidas, efectos secundarios de las solicitudes y relación entre la respuesta y lo que los usuarios ven después.
Dónde aparecen las API en un producto
Prácticamente en cualquier lugar donde los componentes del sistema intercambian datos.
- →Las aplicaciones web y móviles usan API para recuperar y modificar datos.
- →Los servicios internos usan API para trabajar juntos.
- →Las integraciones externas usan API para pagos, entregas, antifraude, correo, SMS y análisis.
- →Las pruebas automatizadas y los scripts auxiliares suelen interactuar con el producto mediante API en lugar de pantallas.
Para QA, las API son una herramienta básica de trabajo, no un tema avanzado para posponer. Cuanto antes empieces a pensar en términos de API, antes dejarás atrás las pruebas superficiales del producto.
Lecturas adicionales
- →En esta base de conocimiento: HTTP y HTTPS — para comprender la capa de transporte de la interacción mediante API.
- →En esta base de conocimiento: Métodos, códigos de estado y encabezados — para aprender cómo interpreta QA las solicitudes y respuestas.
- →Recurso externo: Glosario de API de MDN — una definición concisa y precisa de API.
Para QA, las API son el lenguaje con el que se comunican los componentes del producto. Ver esta capa mejora notablemente la calidad de las pruebas: permite entender tanto qué falló como dónde ocurrió.