Respuesta.

Las pruebas manuales de API son el proceso de verificar el funcionamiento de la interfaz de programación de aplicaciones sin la automatización, utilizando herramientas especializadas como Postman, Swagger o curl.

Historia de la cuestión

Las primeras API se probaron manualmente debido a la falta de automatización y la relativa simplicidad de las interfaces. Hoy en día, a pesar de la automatización, las pruebas manuales siguen siendo significativas, especialmente para la verificación básica de nuevos métodos o de aquellos inestables.

Problema

Las principales dificultades están relacionadas con:

La necesidad de comprensión precisa de la estructura de los datos de entrada y salida (JSON, XML, etc.)
La dificultad para reproducir escenarios complejos (autenticación, dependencia del estado del sistema)
El riesgo de pasar por alto errores ocultos que no son evidentes a través de la interfaz de usuario

Solución

Las pruebas exitosas requieren:

Un trabajo minucioso con la documentación de la API
La creación de conjuntos de solicitudes manuales que cubran diferentes parámetros y escenarios de error
La prueba de escenarios tanto positivos como negativos (validación de datos, verificación de autorizaciones)

Características clave:

La capacidad de verificar rápidamente un nuevo o modificado endpoint sin esperar las pruebas automatizadas
Flexibilidad en el análisis de anomalías y errores cuando el resultado no es evidente
Control visual sobre todas las etapas de la solicitud y respuesta

Preguntas capciosas.

¿Se puede utilizar solo la interfaz de usuario para pruebas manuales de API, sin herramientas como Postman?

No, ya que muchos errores solo se manifiestan a nivel de transferencia de datos y no son visibles a través de la interfaz de usuario; para una verificación completa se requieren herramientas especiales.

¿Es suficiente enviar solo una solicitud válida para verificar el funcionamiento del endpoint de la API?

No, es importante probar no solo solicitudes válidas, sino también todos los casos límite, incorrectos y raros; de lo contrario, los errores no serán encontrados.

¿Es necesario probar los escenarios negativos por separado o es un trabajo innecesario?

Es absolutamente necesario. Es importante asegurarse de que el sistema maneje correctamente los errores y rechace las solicitudes incorrectas; de lo contrario, la seguridad y la estabilidad estarán en riesgo.

Errores típicos y anti-patrones

Probar solo "escenarios ideales" (falta de verificación de valores incorrectos)
Ignorar el estado del sistema: comprobaciones en datos ya existentes o en una base no preparada
Ausencia de validación de encabezados, códigos de error, casos no estándar

Ejemplo de la vida real

Caso negativo

El probador verifica solo la solicitud POST exitosa a la API "crear usuario": envía un JSON correcto, recibe 200 OK, considera que la prueba ha terminado.

Pros:

Verificación rápida del escenario principal

Contras:

Se omiten errores relacionados con la falta de campos, formato incorrecto de email, recreación del mismo usuario
No hay garantía de que la API devuelva el código de error correcto

Caso positivo

El probador verifica sistemáticamente la API "crear usuario":

éxito para una solicitud válida
errores por omitir parámetros obligatorios
error al recrear
verifica diferentes códigos HTTP, mensajes de error, validación de email