Probar API con Postman

Veamos primero lo que dicen los propios autores de Postman:

«Postman es un potente conjunto de herramientas para probar API, de las que muchos desarrolladores ya no prescinden. Hacemos productos excelentes que ayudan a crear interfaces notables y a trabajar con más provecho. Postman lo usan más de un millón de desarrolladores en el mundo, y esa cifra no deja de crecer. Pensamos desarrollar otros productos para dar a los desarrolladores la solución más potente con la que crear y probar API».

La versión actual de Postman es todavía más potente que las antiguas, y buena parte de las funciones Pro están ahora disponibles de balde. Más aún: esta herramienta no se creó solo para desarrolladores. Ni siquiera comprobar respuestas automáticas exige un saber especial. Es una herramienta muy sencilla y a la vez potente.

Enviar una petición

Si abre ese conjunto, va a «Request Methods» y luego a «GET Requests», todos los datos guardados aparecerán en la parte central de la ventana de Postman. Pulse ahora «Submit». Acaba de enviar su primera petición y de recibir la primera respuesta.

Las peticiones POST son algo más delicadas, pero siguen siendo claras y lógicas. Esta vez usará una petición propia. Pulse el signo más para abrir una pestaña nueva, cambie el tipo de petición de GET a POST e indique https://jsonplaceholder.typicode.com/posts como dirección de la petición. Es un servicio REST gratuito que puede usarse con datos ficticios. Resulta muy útil para aprender, imitar el funcionamiento de un servidor y difundir ejemplos de código.

Ahora hace falta el cuerpo de la petición POST. Pulse «Body» bajo la dirección, cambie el tipo a «raw» y «Text» a «JSON». Pegue luego esta consulta en el editor: 

1. {
2. “title”: “My first POST request”,
3. “body”: “Content of my first POST request!”,
4. “userId”: 789
5. }

Pulse «send». Debería recibir una respuesta con su texto, prueba de que la petición salió bien. Guárdela para más adelante. También puede crear una colección nueva: basta pulsar «Save» a la derecha de la dirección. Se abrirá una ventana de guardado donde podrá dar un nombre a la petición y crear para ella una colección nueva.

Las comprobaciones

Otra buena posibilidad de Postman son las comprobaciones automáticas de las peticiones. En cuanto cree una comprobación para una petición, Postman examinará cada respuesta que llegue según sus casos. Veamos un ejemplo sencillo.

Añada una petición nueva para obtener el POST de https://jsonplaceholder.typicode.com/posts con ID = 6 y abra la pestaña «Tests». A la derecha de la ventana de Postman verá una lista de fragmentos. Le ayudará a escribir la primera comprobación, la segunda y todas las siguientes, pues ese código sirve para cualquier cosa: basta ajustarlo un poco a sus necesidades.

tests[“Status code is 200”] = responseCode.code === 200;

1. var jsonData = JSON.parse(responseBody);
2. tests[“User ID is 1”] = jsonData.userId === 1;
3. tests[“Post ID is 6”] = jsonData.id === 6;
4. tests[“Body matches string”] = responseBody.has(“dolorem eum magni eos aperiam quia”);
5. En nuestra primera comprobación veremos si la respuesta a la petición devuelve el estado HTTP «200», si el identificador del usuario es 1 y el de la entrada 6, y si el cuerpo de la respuesta contiene el texto esperado.

Pulse ahora «Submit». Cuando llegue la respuesta, abra la pestaña «Tests» y compruebe si han pasado todas.

Con este artículo queríamos mostrar lo sencillo y grato que resulta trabajar con Postman.