{"id":257,"date":"2020-04-15T10:26:59","date_gmt":"2020-04-15T10:26:59","guid":{"rendered":"https:\/\/javiborras.com\/?page_id=257"},"modified":"2020-04-20T12:19:18","modified_gmt":"2020-04-20T12:19:18","slug":"que-es-postman","status":"publish","type":"post","link":"https:\/\/javiborras.com\/que-es-postman\/","title":{"rendered":"\u00bfQu\u00e9 es Postman?"},"content":{"rendered":"<p class=\"block-bigParagraph medium-txt\">\u00bfQui\u00e9n no ha sufrido el mundo de las APIs en sus huesos? Si eres desarrollador web, y sobre todo te has enfocado en desarrollar tus proyectos en arquitecturas de microservicios, seguro que te has visto en la necesidad de gestionar m\u00faltiples APIs (ya sean propias de tu sistema o integraciones con aplicaciones de terceros) que deben ser mantenidas de la manera m\u00e1s r\u00e1pida y eficiente posible.<\/p>\n<p class=\"block-bigParagraph medium-txt\">En este post vamos a introducirnos en el mundo de Postman, una herramienta que si no la conoc\u00edas, har\u00e1 del trabajo con APIs algo apasionante.<\/p>\n<h2 class=\"block block-header h--h30-15-400 left\">\u00bfQu\u00e9 es Postman?<\/h2>\n<p><strong>Postman surgi\u00f3 originariamente como una extensi\u00f3n para el navegador Google Chrome<\/strong>. A d\u00eda de hoy dispone de aplicaciones nativas para MAC y Windows y est\u00e1n trabajando en una aplicaci\u00f3n nativa para Linux (disponible en versi\u00f3n beta).<\/p>\n<p><strong>Est\u00e1 compuesto por diferentes herramientas y utilidades gratuitas<\/strong>\u00a0(en la versi\u00f3n free)\u00a0<strong>que permiten realizar tareas diferentes dentro del mundo API REST<\/strong>:<\/p>\n<ol>\n<li>Creaci\u00f3n de peticiones a APIs internas o de terceros.<\/li>\n<li>Elaboraci\u00f3n de tests para validar el comportamiento de APIs.<\/li>\n<li>Posibilidad de crear entornos de trabajo diferentes (con variables globales y locales).<\/li>\n<\/ol>\n<p>Todo ello con la posibilidad de ser compartido con otros compa\u00f1eros del equipo de manera gratuita (exportaci\u00f3n de toda esta informaci\u00f3n mediante URL en formato JSON).<\/p>\n<p>Adem\u00e1s,\u00a0<strong>dispone de un modo cloud colaborativo (de pago)<\/strong>\u00a0para que equipos de trabajo puedan desarrollar entre todos colecciones para APIs sincronizadas en la nube para una integraci\u00f3n m\u00e1s inmediata y sincronizada.<\/p>\n<h2 class=\"block block-header h--h30-15-400 left add-last-dot\">Entremos en materia: colecciones de APIs<\/h2>\n<p>El inter\u00e9s fundamental de Postman es que lo utilicemos como una\u00a0<strong>herramienta para hacer peticiones a APIs y<\/strong>\u00a0generar\u00a0<strong>colecciones de peticiones<\/strong>\u00a0que nos permitan probarlas de una manera r\u00e1pida y sencilla.<\/p>\n<p>Las colecciones son carpetas donde se almacenan las peticiones y que permiten ser estructuradas por recursos, m\u00f3dulos o como el equipo lo desee. En la siguiente imagen vemos un ejemplo de estructura de una colecci\u00f3n de prueba de uno de los proyectos desarrollados en Paradigma:\u00a0<a href=\"https:\/\/www.paradigmadigital.com\/portfolio\/security-hub\/\" target=\"_blank\" rel=\"noopener noreferrer\">Security Hub<\/a>.<\/p>\n<article class=\"block block-image -inline-block -like-text-width -center\"><a href=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-1.png\" target=\"\" rel=\"noopener noreferrer\"><img decoding=\"async\" class=\"lazy-img init\" src=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-1.png\" sizes=\"(max-width: 767px) 80vw, 75vw\" srcset=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-1.png 1920w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-1.png 1280w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-1.png 910w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-1.png 455w\" alt=\"\" data-src=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-1.png\" data-srcset=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-1.png 1920w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-1.png 1280w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-1.png 910w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-1.png 455w\" \/><\/a><\/article>\n<p>Como vemos, se puede definir el tipo de petici\u00f3n (GET, POST, etc.), tokens de autenticaci\u00f3n, cabeceras asociadas a la petici\u00f3n, etc., todo de una manera muy sencilla.<\/p>\n<p>Todas las llamadas almacenadas en nuestra colecci\u00f3n pueden ser exportadas a m\u00faltiples lenguajes haciendo clic en el apartado Generate Code que pod\u00e9is ver en la captura anterior. Os dejo un ejemplo de c\u00f3mo exporta una llamada GET para poder ser utilizada autom\u00e1ticamente desde c\u00f3digo Python:<\/p>\n<p>Todas las llamadas almacenadas en nuestra colecci\u00f3n pueden ser exportadas a m\u00faltiples lenguajes haciendo clic en el apartado Generate Code que pod\u00e9is ver en la captura anterior.<\/p>\n<div class=\"code-toolbar\">\n<pre class=\" language-python\"><code class=\" language-python\">\r\n<span class=\"token keyword\">import<\/span> requests\r\nurl <span class=\"token operator\">=<\/span> <span class=\"token string\">\"http:\/\/localhost:8000\/api\/customers\/\"<\/span>\r\nheaders <span class=\"token operator\">=<\/span> <span class=\"token punctuation\">{<\/span>\r\n    <span class=\"token string\">'content-type'<\/span><span class=\"token punctuation\">:<\/span> <span class=\"token string\">\"application\/json\"<\/span><span class=\"token punctuation\">,<\/span>\r\n    <span class=\"token string\">'cache-control'<\/span><span class=\"token punctuation\">:<\/span> <span class=\"token string\">\"no-cache\"<\/span><span class=\"token punctuation\">,<\/span>\r\n    <span class=\"token string\">'postman-token'<\/span><span class=\"token punctuation\">:<\/span> <span class=\"token string\">\"1432412f-9bc5-be13-a8a4-6f93e31feba4\"<\/span>\r\n    <span class=\"token punctuation\">}<\/span>\r\nresponse <span class=\"token operator\">=<\/span> requests<span class=\"token punctuation\">.<\/span>request<span class=\"token punctuation\">(<\/span><span class=\"token string\">\"POST\"<\/span><span class=\"token punctuation\">,<\/span> url<span class=\"token punctuation\">,<\/span> headers<span class=\"token operator\">=<\/span>headers<span class=\"token punctuation\">)<\/span>\r\n<span class=\"token keyword\">print<\/span><span class=\"token punctuation\">(<\/span>response<span class=\"token punctuation\">.<\/span>text<span class=\"token punctuation\">)<\/span>\r\n\r\n<\/code><\/pre>\n<div class=\"toolbar\">\n<div class=\"toolbar-item\"><button>Copy.<\/button><\/div>\n<\/div>\n<\/div>\n<p>Este\u00a0<a href=\"https:\/\/es.wikipedia.org\/wiki\/Snippet\" target=\"_blank\" rel=\"noopener noreferrer\"><em>snippet<\/em><\/a>\u00a0de c\u00f3digo permite ejecutar la petici\u00f3n desde una aplicaci\u00f3n Python tal cual la ejecuta Postman desde su interfaz, pintando la respuesta del servidor por la consola.<\/p>\n<h2 class=\"block block-header h--h30-15-400 left add-last-dot\">Entornos de trabajo<\/h2>\n<p>Uno de los puntos m\u00e1s potentes de Postman, desde mi punto de vista, es la posibilidad de\u00a0<strong>definir todas las variables<\/strong>\u00a0que necesites y clasificarlas\u00a0<strong>por entornos de trabajo<\/strong>.<\/p>\n<p>Esto es muy \u00fatil cuando tienes diferentes proyectos o cuando necesitas configurar m\u00faltiples entornos para un mismo proyecto (por ejemplo, diferentes cabeceras, URLs de cada uno de los entornos de trabajo &#8211; local, preproducci\u00f3n o incluso producci\u00f3n, etc.).<\/p>\n<p>Para configurar los entornos y sus variables, ver\u00e1s que en la esquina superior derecha de la interfaz hay un desplegable en el que se puede leer \u201c<em>No environments<\/em>\u201d. Si haces clic en el bot\u00f3n de ajustes que est\u00e1 al lado, aparece una opci\u00f3n llamada \u201c<em>Manage environments<\/em>\u201d donde se pueden configurar cada uno de ellos:<\/p>\n<article class=\"block block-image -inline-block -like-text-width -center\"><a href=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-2.png\" target=\"\" rel=\"noopener noreferrer\"><img decoding=\"async\" class=\"lazy-img init\" src=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-2.png\" sizes=\"(max-width: 767px) 80vw, 75vw\" srcset=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-2.png 1920w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-2.png 1280w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-2.png 910w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-2.png 455w\" alt=\"\" data-src=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-2.png\" data-srcset=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-2.png 1920w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-2.png 1280w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-2.png 910w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-2.png 455w\" \/><\/a><\/article>\n<p>Una vez configuradas, su uso en cualquier llamada y en cualquier colecci\u00f3n es muy simple. Si por ejemplo definimos la url del recurso con el nombre\u00a0<em>host_url<\/em>\u00a0como variable de entorno (o global), puedes utilizar esta variable escribiendo la clave entre dobles llaves. Por ejemplo:<\/p>\n<article class=\"block block-image -inline-block -like-text-width -center\"><a href=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-3.png\" target=\"\" rel=\"noopener noreferrer\"><img decoding=\"async\" class=\"lazy-img init\" src=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-3.png\" sizes=\"(max-width: 767px) 80vw, 75vw\" srcset=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-3.png 1920w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-3.png 1280w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-3.png 910w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-3.png 455w\" alt=\"\" data-src=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-3.png\" data-srcset=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-3.png 1920w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-3.png 1280w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-3.png 910w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-3.png 455w\" \/><\/a><\/article>\n<p>De esta manera, es muy simple cambiar la URL de todas las llamadas definidas en la colecci\u00f3n (\u00fanicamente deber\u00e1s seleccionar el entorno correspondiente).<\/p>\n<h1 class=\"block block-header h--h20-175-500 left add-last-dot\">Desarrolla tests de APIs en pocos minutos y automat\u00edzalos en tu Jenkins<\/h1>\n<p>Otra de las funcionalidades interesantes, sobre todo para los QAs de los equipos, es\u00a0<strong>la posibilidad de automatizar de una manera sencilla tests de integraci\u00f3n para nuestros proyectos<\/strong>. En cada una de las llamadas, Postman nos proporciona una pesta\u00f1a tests en la que poder configurar los tests que se quieran.<\/p>\n<p>Postman se apoya en c\u00f3digo Javascript para programar sus tests. \u00bfNo sabes c\u00f3mo programar en JS? No te preocupes, Postman se ha preocupado de ofrecer un conjunto de snippets de tests que permiten hacer que desarrollar tus tests no sea m\u00e1s que un juego de ni\u00f1os.<\/p>\n<p>En el\u00a0<a href=\"https:\/\/www.getpostman.com\/docs\/writing_tests\" target=\"_blank\" rel=\"noopener noreferrer\">siguiente enlace<\/a>\u00a0puedes ver m\u00e1s documentaci\u00f3n al respecto de los tests.<\/p>\n<article class=\"block block-image -inline-block -like-text-width -center\"><a href=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-4.png\" target=\"\" rel=\"noopener noreferrer\"><img decoding=\"async\" class=\"lazy-img init\" src=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-4.png\" sizes=\"(max-width: 767px) 80vw, 75vw\" srcset=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-4.png 1920w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-4.png 1280w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-4.png 910w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-4.png 455w\" alt=\"\" data-src=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-4.png\" data-srcset=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-4.png 1920w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-4.png 1280w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-4.png 910w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-4.png 455w\" \/><\/a><\/article>\n<p>Uno de los aspectos m\u00e1s demandados, y que Postman ha desarrollado hace no mucho, es la posibilidad de automatizar los tests para que nuestro software IC ejecute las pruebas dentro del flow de construcci\u00f3n de nuevas versiones.<\/p>\n<p>Todo aquel que est\u00e9 interesado, puede visitar el\u00a0<a href=\"http:\/\/blog.getpostman.com\/2015\/09\/03\/how-to-write-powerful-automated-api-tests-with-postman-newman-and-jenkins\/\" target=\"_blank\" rel=\"noopener noreferrer\">blog de Postman<\/a>, donde se cuenta paso a paso c\u00f3mo integrarlos en Jenkins.<\/p>\n<h1 class=\"block block-header h--h20-175-500 left add-last-dot\">Documenta tu API<\/h1>\n<p>En cada colecci\u00f3n que generes en tu API, Postman da la posibilidad de generar una documentaci\u00f3n web de acceso libre donde pinta todas las llamadas con los headers definidos y, justo al lado, un ejemplo de la llamada para ser probada inmediatamente con cURL:<\/p>\n<article class=\"block block-image -inline-block -like-text-width -center\"><a href=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-5.png\" target=\"\" rel=\"noopener noreferrer\"><img decoding=\"async\" class=\"lazy-img init\" src=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-5.png\" sizes=\"(max-width: 767px) 80vw, 75vw\" srcset=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-5.png 1920w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-5.png 1280w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-5.png 910w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-5.png 455w\" alt=\"\" data-src=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-5.png\" data-srcset=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-5.png 1920w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-5.png 1280w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-5.png 910w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-5.png 455w\" \/><\/a><\/article>\n<p>Para ver la documentaci\u00f3n, hacer clic en la colecci\u00f3n en el s\u00edmbolo \u201c<strong>&gt;<\/strong>\u201d y en el men\u00fa que aparece a la derecha, hacer clic en\u00a0<em>View Docs<\/em>:<\/p>\n<article class=\"block block-image -inline-block -like-text-width -center\"><a href=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-6.png\" target=\"\" rel=\"noopener noreferrer\"><img decoding=\"async\" class=\"lazy-img init\" src=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-6.png\" sizes=\"(max-width: 767px) 80vw, 75vw\" srcset=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-6.png 1920w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-6.png 1280w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-6.png 910w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-6.png 455w\" alt=\"\" data-src=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-6.png\" data-srcset=\"https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-6.png 1920w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-6.png 1280w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-6.png 910w,https:\/\/new.paradigmadigital.com\/wp-content\/uploads\/2017\/01\/postman-6.png 455w\" \/><\/a><\/article>\n<h1 class=\"block block-header h--h20-175-500 left add-last-dot\">Conclusiones<\/h1>\n<p>Sin duda, Postman es una herramienta que se convierte en indispensable desde la primera vez que la utilizas.<\/p>\n<p>Como ayuda al desarrollo, permite al equipo mantener una colecci\u00f3n actualizada de todas las llamadas de tu servicio o una colecci\u00f3n que permita probar r\u00e1pidamente la integraci\u00f3n con APIs de terceros.<\/p>\n<p>A d\u00eda de hoy, existen aplicaciones nativas de Postman para Windows, OSX y Linux (beta), por lo que cualquier desarrollador puede beneficiarse de sus ventajas.<\/p>\n<p>Adem\u00e1s, la posibilidad de exportar toda la colecci\u00f3n en un fichero\u00a0<em>.json<\/em>\u00a0permite al equipo versionar la colecci\u00f3n en el sistema de control de versiones, y que sea un documento colaborativo que ayude a todos los componentes del equipo a tener su colecci\u00f3n actualizada de una manera inmediata.<\/p>\n","protected":false},"excerpt":{"rendered":"<p>\u00bfQui\u00e9n no ha sufrido el mundo de las APIs en sus huesos? Si eres desarrollador web, y sobre todo te has enfocado en desarrollar tus proyectos en arquitecturas de microservicios, seguro que te has visto en la necesidad de gestionar m\u00faltiples APIs (ya sean propias de tu sistema o integraciones con aplicaciones de terceros) que [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":0,"comment_status":"closed","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_seopress_robots_primary_cat":"","_seopress_titles_title":"","_seopress_titles_desc":"","_seopress_robots_index":"","ub_ctt_via":"","_kadence_starter_templates_imported_post":false,"footnotes":""},"categories":[7],"tags":[],"class_list":["post-257","post","type-post","status-publish","format-standard","hentry","category-blog"],"featured_image_src":null,"author_info":{"display_name":"Javi Borr\u00e0s","author_link":"https:\/\/javiborras.com\/author\/jborrasbonet\/"},"_links":{"self":[{"href":"https:\/\/javiborras.com\/wp-json\/wp\/v2\/posts\/257","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/javiborras.com\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/javiborras.com\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/javiborras.com\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/javiborras.com\/wp-json\/wp\/v2\/comments?post=257"}],"version-history":[{"count":0,"href":"https:\/\/javiborras.com\/wp-json\/wp\/v2\/posts\/257\/revisions"}],"wp:attachment":[{"href":"https:\/\/javiborras.com\/wp-json\/wp\/v2\/media?parent=257"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/javiborras.com\/wp-json\/wp\/v2\/categories?post=257"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/javiborras.com\/wp-json\/wp\/v2\/tags?post=257"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}