<?xml version="1.0" encoding="UTF-8"?><rss xmlns:dc="http://purl.org/dc/elements/1.1/" xmlns:content="http://purl.org/rss/1.0/modules/content/" xmlns:atom="http://www.w3.org/2005/Atom" version="2.0" xmlns:cc="http://cyber.law.harvard.edu/rss/creativeCommonsRssModule.html">
    <channel>
        <title><![CDATA[Stories by Alexander Kuvshinov on Medium]]></title>
        <description><![CDATA[Stories by Alexander Kuvshinov on Medium]]></description>
        <link>https://medium.com/@alex.kuvshinov?source=rss-19e816ce3a00------2</link>
        <image>
            <url>https://cdn-images-1.medium.com/fit/c/150/150/2*u2QG-vW9hMoDT19zBlxQgg.jpeg</url>
            <title>Stories by Alexander Kuvshinov on Medium</title>
            <link>https://medium.com/@alex.kuvshinov?source=rss-19e816ce3a00------2</link>
        </image>
        <generator>Medium</generator>
        <lastBuildDate>Fri, 20 Nov 2026 00:41:26 GMT</lastBuildDate>
        <atom:link href="https://medium.com/@alex.kuvshinov/feed" rel="self" type="application/rss+xml"/>
        <webMaster><![CDATA[yourfriends@medium.com]]></webMaster>
        <atom:link href="http://medium.superfeedr.com/" rel="hub"/>
        <item>
            <title><![CDATA[Test-Free or Bug-Free? It’s Always Your Choice.]]></title>
            <link>https://medium.com/rosberryapps/test-free-or-bug-free-its-always-your-choice-bd7540362f6c?source=rss-19e816ce3a00------2</link>
            <guid isPermaLink="false">https://medium.com/p/bd7540362f6c</guid>
            <category><![CDATA[test-automation]]></category>
            <category><![CDATA[quality-assurance]]></category>
            <category><![CDATA[testing]]></category>
            <category><![CDATA[mobile]]></category>
            <category><![CDATA[qa]]></category>
            <dc:creator><![CDATA[Alexander Kuvshinov]]></dc:creator>
            <pubDate>Thu, 25 Feb 2021 10:52:23 GMT</pubDate>
            <atom:updated>2022-05-18T05:21:26.608Z</atom:updated>
            <content:encoded><![CDATA[<h3><strong>Tester-Free or Bug-Free? It’s Always Your Choice.</strong></h3><p><em>By Alexander Kuvshinov, Quality Assurance Engineer at </em><a href="https://rosberry.com/"><em>Rosberry</em></a></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*5lX-vfQIwvO9IJTiVFFcZg.png" /></figure><p>In May 2020 Rosberry celebrated its tenth anniversary. For a fairly young mobile app design and development industry 10 years of work is a pretty solid term. Of course, over this time we have suffered a certain amount of bumps and bruises, but have also built a good knowledge base and collected piles of analytics, which we love sharing from time to time with the readers of our <a href="https://medium.com/rosberryapps">publication.</a></p><p>This time we’ve decided to pay special attention to the issue we often face with our clients when signing a contract. The question is always asked differently, but its essence can be worded in the following way: “Is it possible to do without professional testing and check the application for quality all by yourself?” More often than not such type of questions arise when the budget for project implementation is tight and from the outside looking in testing might seem to be the service you can give up on without much damage to the final product.</p><p>To understand if this can be the case, let’s first define what testing is and what tasks a QA specialist usually solves when a mobile application is developed.</p><blockquote><em>International Organization for Standardization (ISO) suggests that testing is the process of research and software check aiming to find out if the actual behaviour of the software (in our case a mobile application) matches the expected behaviour using a set of specially selected tests (ISO/IEC TR 19759:2005).</em></blockquote><p>At the first glance the definition does not seem to entail any complex procedures — you install the application, compare the actual and expected behaviour using a pre-selected set of tests, and, ta da, the product is ready to be released.</p><p>But what kind of tests will there be? What is supposed to be the expected behaviour? What exactly do you have to test and check to call your app a high-quality one?</p><p>To eliminate possible difficulties of future users to the max, a professional QA specialist in most cases resorts to a whole range of actions and operations. Let’s say we are developing a native app for iOS and Android. One would think that these are just two platforms that require testing. But it’s not that simple. Operating systems (platforms) are updated at least once a year which implies a certain number of versions that can be considered outdated, but would still work on millions of devices, and therefore would require support and testing. What this means is that to develop and test an app we have to deal with not just 2 versions, but with a whole number of them, especially given that many manufacturers (Samsung, Xiaomi, Huawei, etc.) often customize user interfaces for their devices.</p><p>Moreover the competition in the smartphone market is forcing device manufacturers to offer customers more and more models with new features and functionalities introduced: biometric authentication instead of a password, three cameras instead of one, contactless payments and lots of others. All these innovations can not but affect mobile applications, so the company engaged in mobile development should always have an extensive fleet of real devices supplemented and updated on a regular basis. Many will say, but there are many cloud services that offer testing with the so-called emulators, i.e. programs that mimic the hardware and software of the target device on your computer. Yes, they help a lot, but unfortunately can not 100% replace real devices.</p><p>Or let’s take an elementary functionality when the choice of the country in the app settings determines the content in the app itself.</p><p>What can be checked here from a user’s perspective?</p><ul><li>Select a country from the list of countries.</li><li>Make sure that the content corresponds to the selected country.</li><li>That’s it.</li></ul><p>And what can actually be hidden behind this simple action? What tests should be carried out? The QA specialist will at least have to:</p><ul><li>Check the boundary values, i.e. do not select anything, select multiple countries, maximum number of countries.</li><li>Reverse check, i.e. deselect and check for changes to the content.</li><li>Make sure that the data received from the server is correct.</li><li>Make sure that the content in different languages is displayed correctly.</li><li>Understand that the application is functioning with no Internet connection.</li><li>See how the application behaves when forced to shut down.</li><li>Check how the app looks on different displays and works with different versions of operating systems.</li><li>Simulate the behaviour of different users, different target audiences, check against negative scenarios, use tricky actions and different testing conditions.</li><li>Test the function of changing the screen orientation when rotating the device.</li></ul><p>Of course, that is just one simple example of testing one small functionality. In most cases, the mobile application passes several types of testing at once which in its turn guarantees an appropriate level of quality of the final product:</p><p><strong>Functional testing</strong> is a kind of black-box testing that is performed to confirm that the functionality of an application or system is behaving as expected.</p><p><strong>Change-related testing — </strong>validation of the changes implemented as to their influence on the main app functions.</p><p><strong>Non-functional testing </strong>— testing of performance, security, usability, and design.</p><p><strong>Regression testing</strong> is a type of testing that is performed at the very end of the project, or during a major update of a certain version of the application. This is about testing the entire application from start to finish.</p><p>Actually, using all these types of testing is quite a difficult task for an untrained person.</p><p>Moreover, for the testing process to be predictable and manageable, it is also necessary to prepare the appropriate infrastructure and documentation in advance. For example at Rosberry quality assurance starts immediately after the design phase is over. The QA engineer builds the quality assurance process as a system starting with BDD scenarios.</p><p>BDD scenario is a written description of the product’s behaviour from one or more users’ perspectives. Each scenario allows even the most untrained person to understand how a user will interact with the application. The scenarios cover all possible user behaviours. This is a clear and a detailed document that together with the design layouts gives a complete picture of the product being created. BDD scenarios at the development stage become the basis for testing of application.</p><p>Yet, again it turns out that the preparation for testing begins much earlier than the customer has the time to notice it. And this type of work also requires appropriate training and knowledge.</p><p><strong>Bottomline</strong></p><p>So, whether you will go with or without a QA specialist is always your choice. But we believe that if there is a QA specialist within your project, you will have much more confidence in the high quality of the product. Development without a professional tester can be compared to a walk through the forest blindfolded running into trees, bumps, branches and what not. You can go forward but it is highly likely you will stumble and fall. A QA specialist will remove the blindfold and clear the way. A tester is like a special-purpose tool, say a cheese knife. Of course, you can use a knife for fish, a knife for meat, bread, or anything to slice cheese. But it is a special knife that will make slicing more convenient and faster. Each item in the kitchen has its own purpose, right? The same with a QA specialist within your project. The cheese is your app, a QA specialist is a sharp cheese knife.</p><iframe src="https://cdn.embedly.com/widgets/media.html?src=https%3A%2F%2Flcontacts.herokuapp.com%2Fembed%2Fbutton%2Fwritercta%3FmediumUserId%3D1e15fc2a4a5d8417546fd90faf1aa6a157fce8081f7e2822785c1a94f3df5ec7f%26userId%3D5c9051cb6b86e65745ffed99&amp;display_name=Smedian&amp;url=https%3A%2F%2Flcontacts.herokuapp.com%2Fembed%2Fbutton%2Fwritercta%3FuserId%3D5c9051cb6b86e65745ffed99%26mediumUserId%3D1e15fc2a4a5d8417546fd90faf1aa6a157fce8081f7e2822785c1a94f3df5ec7f&amp;key=a19fcc184b9711e1b4764040d3dc5c07&amp;type=text%2Fhtml&amp;schema=lcontacts" width="480" height="350" frameborder="0" scrolling="no"><a href="https://medium.com/media/2da47a6a5cd5e91b65a9c9515ddfe0ea/href">https://medium.com/media/2da47a6a5cd5e91b65a9c9515ddfe0ea/href</a></iframe><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=bd7540362f6c" width="1" height="1" alt=""><hr><p><a href="https://medium.com/rosberryapps/test-free-or-bug-free-its-always-your-choice-bd7540362f6c">Test-Free or Bug-Free? It’s Always Your Choice.</a> was originally published in <a href="https://medium.com/rosberryapps">@RosberryApps</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Postman — Collection runner, тесты и сниппеты (Snippets), запуск тестов в CI через Newman.]]></title>
            <link>https://medium.com/effective-developers/postman-collection-runner-%D1%82%D0%B5%D1%81%D1%82%D1%8B-%D0%B8-%D1%81%D0%BD%D0%B8%D0%BF%D0%BF%D0%B5%D1%82%D1%8B-snippets-%D0%B7%D0%B0%D0%BF%D1%83%D1%81%D0%BA-%D1%82%D0%B5%D1%81%D1%82%D0%BE%D0%B2-%D0%B2-ci-%D1%87%D0%B5%D1%80%D0%B5%D0%B7-newman-3645d4620655?source=rss-19e816ce3a00------2</link>
            <guid isPermaLink="false">https://medium.com/p/3645d4620655</guid>
            <category><![CDATA[qa]]></category>
            <category><![CDATA[testing]]></category>
            <category><![CDATA[postman]]></category>
            <category><![CDATA[api]]></category>
            <category><![CDATA[test]]></category>
            <dc:creator><![CDATA[Alexander Kuvshinov]]></dc:creator>
            <pubDate>Thu, 07 May 2020 04:59:01 GMT</pubDate>
            <atom:updated>2020-05-07T04:59:01.221Z</atom:updated>
            <content:encoded><![CDATA[<h3>Postman — Collection runner, тесты и сниппеты (Snippets), запуск тестов в CI через Newman.</h3><p>В <a href="https://medium.com/effective-developers/a190a0a9617">предыдущей статье</a> уже была затронута такая функциональность Postman, как collection runner. Runner был рассмотрен там как инструмент для создания инкремента значений, но назначение этой фичи не только в этом. Основная его функция в автоматическом прогоне запросов по нажатию на одну кнопку. К запросам можно прикрутить и сами тесты с помощью сниппетов, о них я тоже расскажу в этой статье, а также разберём запуск тестов через CI с помощью Newman.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*GyQxSDbB3EM213ha.jpg" /></figure><h3>Postman collection runner.</h3><p>Итак, коллекция создана и все запросы расположены как вам нужно. Теперь, чтобы проверить весь API, нужно вручную прогонять каждый запрос. Звучит неудобно. Специально для прогона всех запросов существует runner. Эта функциональность Postman запускает поочерёдно все запросы, которые есть в коллекции.</p><p>Разберём Postman collection runner на уже полюбившейся тестовой коллекции <a href="https://docs.postman-echo.com/?version=latest">Postman echo:</a></p><ul><li>Скачиваем коллекцию с ресурса, указанного выше (<em>представим, что добрый QA или разработчик заботливо предоставил вам эту коллекцию для API вашего проекта, которая уже заполнена, и даже тесты есть</em>).</li><li>Сразу запускаем на этой коллекции runner.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*N_banZZVFNj1Hkcm" /></figure><ul><li>В открывшемся окне runner’а нажимаем на кнопку “Run %collection name%”.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*_BJaMgEVvPN_LHYK" /></figure><ul><li>Происходит процесс прогона всей коллекции. По окончании прогона — видим статистику по успешным/неуспешным запросам и тестам, которые были прописаны в каждом запросе.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*T51cC8hBQzTBAW_6" /></figure><ul><li>Нажимаем оранжевую кнопку “Run summary”, чтобы систематизировать отчёт.</li></ul><p>В целом, мы протестировали всю коллекцию нажатием пары кнопок, а не прогоном каждого запроса по отдельности. Это очень полезно, когда на бэкенде произошла масштабная работа, и после деплоя могло что-то отвалиться. Один прогон раннером позволяет понять, что деплой что-то сломал или, наоборот, всё в порядке. Но почему же некоторые запросы отработали неверно?</p><p>На summary можно отсеять успешные запросы/тесты и посмотреть только те, которые были провалены. Для этого в левой части интерфейса нужно нажать на красный квадрат.</p><p>Развернув один из неуспешных запросов (например Hawk Auth), можно увидеть, что в запросе был прописан тест, и он провалился.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*YFaI5PXunXdPZSsk" /></figure><p>Вернёмся в основной интерфейс Postman, прогоним этот запрос отдельно и заглянем во вкладку “tests”.</p><p>После выполнения запроса стандартным способом, можно увидеть, что статус был OK 200, ответ пришёл верный (авторизация прошла успешно), но тесты выполнены лишь наполовину: один из двух. Разберёмся, что за тесты были прописаны в этом запросе.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*Fh7AfWorIDDpsqwM" /></figure><p>Первый тест был направлен на то, чтобы статус ответа был OK и код 200. Здесь всё понятно, мы видим, что статус ответа “200 ОК”. А что насчёт второго, который был провален?</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*RHOVPBmoJY7HT2lg" /></figure><p>На самом деле, всё просто. Здесь содержится тест на проверку того, что body ответа содержит слова “status” и “pass”. По факту, body имеет другое содержание, а именно:</p><p><em>{</em></p><p><em>“message”: “Hawk Authentication Successful”</em></p><p><em>}</em></p><p>Изменим тест так, чтобы он был успешен. Берём сниппет (о сниппетах расскажу позже в этой статье), который отвечает за проверку содержания body в ответе, который был прописан, но не подходит по условиям проверки.</p><p><em>pm.test(“response body has json saying passed ‘status’”, function () {</em></p><p><em>pm.response.to.have.jsonBody(‘status’, ‘pass’);</em></p><p><em>});</em></p><p>Отредактируем его под наш сценарий:</p><p><em>pm.test(“response body has json saying ‘Hawk Authentication Successful’”, function () {</em></p><p><em>pm.response.to.have.jsonBody(‘message’, ‘Hawk Authentication Successful’);</em></p><p><em>});</em></p><p>В первой строчке указано название теста. Я его назвал: body ответа в формате json содержит “Hawk Authentication Successful”. Сама проверка идёт второй строчкой: ответ содержит строчку “message” с содержанием “Hawk Authentication Successful”.</p><p>Пробуем снова отправить этот запрос с обновленным тестом:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*loc92CjVdf2ngoWs" /></figure><p>В итоге в процессе прогона коллекции в Postman Runner мы больше не увидим ошибку на запросе “Hawk Auth”. По аналогии можно отредактировать все тесты на все запросы и иметь мега-коллекцию с тестами и с прогоном тестов всего API в 3 клика.</p><p>Редактировать готовые тесты несложно, просто подменяя неправильные значения, которые ожидает увидеть тест на те, которые приходят (если они правильные). Но что делать, если тесты никто не прописывал до вас? Прописать их самим, конечно же! :)</p><h3>Snippets</h3><p>После открытия вкладки “Tests” внимание привлекает список справа.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*-aVeNMMSu-NmG_wA" /></figure><p>Это те самые сниппеты, которые помогут в написании тестов, прогоняемых в раннере. Сниппеты все разные и можно выбрать те, которые обеспечат максимальное покрытие запроса тестами. Например:</p><ul><li>проверить статус-код ответа</li><li>проверить наличие string строки в ответе или конкретного значения внутри JSON</li><li>проверить время ответа</li><li>проверить наличие определенного заголовка в ответе</li><li>конвертировать XML ответ в JSON объект</li></ul><p>Давайте попробуем прописать свои тесты на какой-либо запрос, используя всё ту же коллекцию Postman echo.</p><p>Покажу на примере запроса в папке “Request methods”, называемого “Get request”. Для начала нам нужно очистить все тесты, которые там были прописаны до нас.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*u_aMFw-S7n4BPMg6" /></figure><p>После этого выполнить успешный запрос кнопкой “Send”.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*odvwpGyK07Fz3GNL" /><figcaption>Получили важную информацию, которую можно прописать тестами, а именно: статус ответа 200 OK, время исполнения 998ms и body ответа.</figcaption></figure><p>В сниппетах нужно выбрать “Status code is 200” и автоматически подставляется схема теста. Если нужен какой-либо другой код ответа, просто правим его руками с 200 на любой другой, в зависимости от положительного сценария.</p><p>Далее нужно выбрать “Response time is less than 200ms” сниппет, чтобы проверить время ответа. Поскольку нам пришло значение в 998ms, будем считать, что валидное значение — 1000ms. Правим это в коде теста, который подставляется автоматически после нажатия на сниппет.</p><p>Последний тест, который я пропишу, будет на проверку верно пришедшего body JSON. Нужно выбрать сниппет “response body: is equal to a string”. Название у теста автоматически назначается “Body is correct”. Сделаем проверку на то, что в body пришли следующие значения:</p><p><em>“args”: {</em></p><p><em>“foo1”: “bar1”,</em></p><p><em>“foo2”: “bar2”</em></p><p><em>},</em></p><p>В итоге тест будет выглядеть следующим образом:</p><p><em>pm.test(“response body has json with request queries”, function () {</em></p><p><em>pm.response.to.have.jsonBody(‘args.foo1’, ‘bar1’)</em></p><p><em>.and.have.jsonBody(‘args.foo2’, ‘bar2’);</em></p><p><em>});</em></p><p>(Стоит обратить внимание, что перед “body” я прописал “json”, т.к. ответ приходит именно в json формате)</p><p>В итоге все 3 теста будут иметь следующий вид:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*aeBrUK19zHxaK-ag" /></figure><p>Если выполнить запрос, внизу во вкладке “Test Results” будет 3/3 успешных. Можно смело переходить к следующему запросу и прописывать ему свои тесты. А далее, через Postman Runner прогонять все свои запросы и тесты, когда это потребуется.</p><h3>Newman и запуск тестов в CI.</h3><p>Когда у нас в руках такая мощь, как весь API с тестами в формате Postman Collection, грех не использовать эту библиотеку при деплое кода на бэкенд, чтобы через CI все тесты прогонялись автоматически.</p><p>Newman — это cli приложение, которое позволяет запускать Postman коллекцию с консоли. Его можно легко интегрировать в ваш CI. Я расскажу, как я запускал Newman у себя на локалке, но принцип запуска на CI тот же.</p><p>Для использования Newman предварительно нужно установить Node.js. Если Node.js уже есть, то нужно убедиться, что его версия 10 или выше. Гайдов по установке много, для примера можно воспользоваться <a href="https://www.guru99.com/download-install-node-js.html">этим</a>.</p><p>После того, как всё установлено, нужно открыть консоль и установить сам Newman с помощью команды:</p><p><em>npm install -g newman</em></p><p>Далее, нам нужно получить URL нашей коллекции. Как это делается, я уже писал, но повторю: напротив нужной коллекции в Postman нужно нажать на кнопку опций (…) и выбрать пункт “Share collection”.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*jSSgA60Ia_vzrtoZ" /></figure><p>После этого откроется окно шаринга, в нём нужно выбрать пункт “Get public link” и нажать на кнопку “Get public link”, после чего генерируется ссылка на выбранную коллекцию (которая будет содержать в себе все прописанные тесты).</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*Epp6y1wVuoeaWRYv" /></figure><p>Также можно взять сам файл коллекции, а не URL. Скачивание .JSON файла коллекции осуществляется с помощью пункта “Export” после нажатия той же кнопки опций (…), далее сохраняем файл на диск.</p><p>Newman установлен, ссылка на коллекцию или .JSON файл есть. Теперь запускаем тесты в консоли следующей командой:</p><p><em>newman run </em><a href="https://www.getpostman.com/collections/65bd30a9d3e7243f3f02"><em>https://www.getpostman.com/collections/65bd30a9d3e7243f3f02</em></a><em> <br></em>(URL нужно подставить тот, который получили при шаринге и нажатии на кнопку “Get public link”)</p><p>Для запуска newman из файла .JSON нужно использовать команду с директорией файла коллекции. Например:</p><p><em>newman run /Users/Alienware/Desktop/Postman Echo.postman_collection.json</em></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/682/0*-_DzftBI4ifogP9l" /></figure><p>Вся коллекция была протестирована одной командой. Также присутствует аналитика, которая показывает, сколько всего было запросов, сколько тестов, какие прошли, какие нет. Надстройкой в вашем CI можно прописать, чтобы этот прогон выполнялся после каждого деплоя на бекенд. Вы великолепны!</p><p>После прочтения всех моих статей и практического использования знаний, можно смело добавлять ещё одну увесистую строчку в ваше резюме.</p><p>Ну а если ещё не читали — вот ссылки:</p><ul><li><a href="https://medium.com/effective-developers/6c0f76358cf2">1) Postman — как инструмент тестирования API</a></li><li><a href="https://medium.com/effective-developers/125c6de936d7">2) Postman — менеджмент, структурирование, импорт и экспорт коллекций</a></li><li><a href="https://medium.com/effective-developers/a190a0a9617">3) Postman — cмена окружений, предварительная настройка авторизации, установка переменных</a></li></ul><p>Огромное спасибо за прочтение!</p><p>Если вам или кому-то из ваших знакомых нужно разработать качественное мобильное приложение, веб-сервис или помочь в решении бизнес-задач, смело обращайтесь к нам в Effective, мы готовы сотрудничать с вами в любом виде: как на проекте целиком, так и на аутстаф. Связаться с нами можно через почту <strong>contact@effective.band</strong></p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*zBkeoyXLJl1r_ndQ.jpeg" /></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=3645d4620655" width="1" height="1" alt=""><hr><p><a href="https://medium.com/effective-developers/postman-collection-runner-%D1%82%D0%B5%D1%81%D1%82%D1%8B-%D0%B8-%D1%81%D0%BD%D0%B8%D0%BF%D0%BF%D0%B5%D1%82%D1%8B-snippets-%D0%B7%D0%B0%D0%BF%D1%83%D1%81%D0%BA-%D1%82%D0%B5%D1%81%D1%82%D0%BE%D0%B2-%D0%B2-ci-%D1%87%D0%B5%D1%80%D0%B5%D0%B7-newman-3645d4620655">Postman — Collection runner, тесты и сниппеты (Snippets), запуск тестов в CI через Newman.</a> was originally published in <a href="https://medium.com/effective-developers">Effective</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Postman. Смена окружений, настройка авторизации запросов,  установка переменных.]]></title>
            <link>https://medium.com/effective-developers/postman-%D1%81%D0%BC%D0%B5%D0%BD%D0%B0-%D0%BE%D0%BA%D1%80%D1%83%D0%B6%D0%B5%D0%BD%D0%B8%D0%B9-%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B0%D0%B2%D1%82%D0%BE%D1%80%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2-%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%BF%D0%B5%D1%80%D0%B5%D0%BC%D0%B5%D0%BD%D0%BD%D1%8B%D1%85-a190a0a9617?source=rss-19e816ce3a00------2</link>
            <guid isPermaLink="false">https://medium.com/p/a190a0a9617</guid>
            <category><![CDATA[postman]]></category>
            <category><![CDATA[digital]]></category>
            <category><![CDATA[tools]]></category>
            <category><![CDATA[testing]]></category>
            <category><![CDATA[qa]]></category>
            <dc:creator><![CDATA[Alexander Kuvshinov]]></dc:creator>
            <pubDate>Thu, 09 Jan 2020 08:40:37 GMT</pubDate>
            <atom:updated>2020-04-02T07:46:16.805Z</atom:updated>
            <content:encoded><![CDATA[<h3>Postman. Смена окружений, предварительная настройка авторизации, установка переменных.</h3><p>В предыдущей статье была затронута тема менеджмента коллекций, как лучше всё разложить по полочкам и какие виды коллекций можно создать. Также коснулись темы импорта и экспорта. Эта статья расскажет вам, как сделать предустановки для запросов, как менять окружения, на которые будут отправляться запросы. Рассмотрим способ предавторизации перед запросом, а также попробуем разобраться с инкрементом значений в теле запроса.</p><h3>Смена окружений с помощью переменных</h3><p>Обычно у проекта есть несколько окружений, как минимум dev + production, в лучшем случае — больше. И существуют ситуации, когда API следует протестировать на нескольких окружениях, но есть ли смысл создавать коллекции под каждое окружение? В случае с Postman — нет, так как там существует поддержка окружений (environments).</p><p>Чтобы использовать окружения, следует каждое из них настроить. Например, есть production окружение (я буду использовать открытое API от разработчиков Postman — Postman Echo <a href="https://postman-echo.com/">https://postman-echo.com</a>) и для настройки нужно выполнить следующие шаги:</p><ul><li>Во-первых, нажать на иконку шестеренки в правом верхнем углу интерфейса клиента.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*ieY2twl3lPiBfULI" /></figure><ul><li>Далее нужно создать окружение кликнув на кнопку “Add” (или если никаких окружений ещё не добавлено, кликнуть на надпись “Create an environment”)</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/899/0*fyQQDQhLJfDEqW1K" /></figure><ul><li>На экране добавления окружения следует назвать новое окружение</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/900/0*N8MkS2XQnQ_PwM9X" /><figcaption>1) Это как будет называться само окружение, при выборе его в правом верхнем углу в выпадающем меню 2) Как будет в строке URL запроса вызываться нужное окружение 3) Ссылка на API нужного окружения.</figcaption></figure><ul><li>Нажать на кнопку “Add”</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/899/0*pxujSo0hXRBz_T-S" /></figure><p>Готово, окружение создано. Чтобы его использовать, необходимо иметь уже готовую коллекцию с заполненными запросами. Покажу всё на той же коллекции запросов к API Postman-Echo.</p><ul><li>Открыть коллекцию</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*hZb2F9PCjI73zvZT" /><figcaption>Скачать коллекцию себе можно по ссылке: <a href="https://docs.postman-echo.com/?version=latest">https://docs.postman-echo.com/?version=latest</a> справа вверху нажав на оранжевую кнопку “Run in Postman”)</figcaption></figure><ul><li>Выбрать любой из запросов. Пусть это будет “GET request” из папки “Request Methods”</li><li>В правом верхнем углу выбрать нужное окружение</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*0kDWfmpubdv0wN8o" /><figcaption>(на Postman-Echo нет тестового окружения в открытом доступе, поэтому окружение “QA” в списке для наглядности)</figcaption></figure><ul><li>После выбора окружения следует указать в URL запроса переменную, которую мы указывали при создании окружения. (Под цифрой “2”) А именно {{prod}} через двойные фигурные скобки.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*bv5NKhTVMaxf7wpw" /></figure><ul><li>Выполнив запрос кнопкой “Send”, можно убедиться, что окружение настроено правильно и приходит верный ответ.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*hKmjtAHAKp2rIAIW" /></figure><p>Также можно установить любое другое предустановленное окружение (Development, QA и т.д), нужно только выбрать его в правом верхнем выпадающем меню и изменить переменную, которая будет подставлять нужный Base URL.</p><h3>Установка авторизации перед запросом</h3><p>Настало время разобраться с тем, как установить значения для логина пользователя без запроса на логин. <a href="https://medium.com/effective-developers/125c6de936d7">В предыдущей статье про менеджмент коллекций</a> в списке запросов были постоянно повторяющиеся запросы “Login”. Рассмотрим, как установить авторизацию перед выполнением любого запроса, без постоянных запросов Login.</p><p>Представим, есть запрос на получение информации о пользователе. Сам запрос представляет из себя схему GET-&gt;URL без всяких Params, в которых иногда можно прописывать Username и Password. В нашем случае в “Params” эти переменные отсутствуют. Залогиниться в таком случае поможет вкладка “Authorization”.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*bEuaYvpNaGa-0MjC" /></figure><p>При переключении на эту вкладку сразу видно, какой тип авторизации будет использован. В основном логин происходит либо по Token, либо по связке Username — Password (что в итоге тоже приводит к получению токена, но архитектура API может работать по-разному). В примере авторизация будет успешной по связке Username — Password. В левой части окна нужно выбрать тип “Basic Auth” и в правой части указать валидные Username и Password. После ввода этих данных и нажатия на кнопку “Preview Request”, получившийся token подставится во вкладку Headers и будет доступен. После этого, можно отсылать запрос и получить информацию о пользователе.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*54uZ9pQem2a5URa3" /></figure><p>Теперь во всех запросах этой коллекции будет предустановлен полученный token при предавторизации.</p><p>Рассмотрим вид авторизации по токену. Он мало чем отличается от предыдущего метода, но для него нам предварительно понадобится получить токен пользователя через отдельный Login запрос.</p><p>- Выполнить запрос Login для получения токена</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*adVQUM30uzmFqsDe" /></figure><p>Теперь в любом другом запросе, где нужно, чтобы пользователь был изначально залогинен, во вкладке Authorization нужно выбрать тип авторизации — bearer token, ну а справа ввести тот токен, который был получен в запросе авторизации.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*WhF35mwaR0NaGc-j" /></figure><p>Запрос на авторизацию так же будет происходить перед выполнением основного запроса, как и в случае с введенными Username + Password. Остальные типы авторизации работают примерно по такому же сценарию.</p><h3>Инкремент значений в теле запроса</h3><p>Есть задача: создать кучу аккаунтов, но разных, чтобы не повторялась почта пользователя. Как сделать так, чтобы вручную каждый запрос не редактировать под свою задачу, а за один прогон сразу создать 10 аккаунтов с разной почтой? В этом поможет такая функциональность Postman, как Collection Runner, который из таблицы .CSV будет брать заранее прописанные данные.</p><p>В примере разберу запрос из коллекции Postman-echo “POST Raw Text” из папки “Request Methods” где нужно отправить в запросе POST текст, который вернётся в ответе от сервера вместе с другой информацией о создании записи.</p><ul><li>Вынесем нужный запрос в отдельную коллекцию, которую я назвал “Effective”:</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*5uXKL_1OvYB_EbQl" /></figure><ul><li>После этого, нужно создать .CSV файл. По сути, можно сделать это через google.docs или старый добрый Excel. В первой ячейке столбца нужно написать ту переменную, которую мы будем передавать в body запроса (об этом позже) и далее нужно указать значения, которые нужно подставлять при каждом следующем запросе. Если это 10 e-mail адресов, указывайте 10 разных e-mail адресов, если цифры — тогда цифры и так далее. Я указываю в первой строке название переменной “Effective”, и ниже идут 10 значений, которые будут подставляться по очереди. В каждой итерации запроса — новое значение для подстановки:</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1000/0*6gnShA8eoRWd8mhi" /></figure><ul><li>Сохранить документ как .CSV</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/968/0*Gl8B3-KJXXvrob2E" /></figure><ul><li>Проверить запрос на правильность. Отправить неотредактированный запрос из коллекции, который мы вынесли отдельно. Убедиться, что ответ приходит тот, который нужен.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*FSKN_UVZo2oo3lVv" /><figcaption>В ответе находится тот же самый текст, который мы передавали. Значит всё отработало верно.</figcaption></figure><ul><li>После этого, во вкладке “raw”, вместо дефолтного текста нужно подставить переменную {{…}} такого вида. В моём случае эта переменная будет {{Effective}}, т.к. в таблице .CSV первая строчка в столбце называется именно так. Помимо этого, нужно в формате данных указать JSON (либо на вкладке headers указать “content-type: application/json” вместо “content-type: text/plain”) + после этого нужно сохранить измененный запрос кнопкой “Save”.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*ccQguciekItVtwlK" /></figure><ul><li>Далее нужно выбрать свою коллекцию: в правой части нажать на кнопку “&gt;” (1) и нажать на кнопку “Run” (2)</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*91PnYh5IGSvYtRlx" /></figure><ul><li>Откроется Postman Collection Runner. На экране раннера в поле “Data” нужно выбрать тот самый .CSV файл, который был создан ранее. При этом количество итераций автоматически изменится на то количество строк, которое есть в документе. (Первая строка не берётся в расчёт, т.к. это название переменной, и только после неё идут значения для подстановки). Также можно указать задержку (Delay) между запросами, если это требуется.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*8fq4sWjb2R8Us8zN" /></figure><ul><li>Нажать на кнопку “Run *collection name*”</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*c2oeKvnLWjEowDqL" /></figure><p>Если всё сделать верно, все 10 итераций пройдут успешно. Тут можно добавить, что количество итераций, если выбирать их вручную, должно быть равно количеству строк в .CSV документе, иначе прогон не запустится. Открыв Request Body можно увидеть, что все body в запросах были разными, следовательно один запрос был отправлен много раз с разными данными. Также можно добавить невалидные данные для негативных проверок, т.е. вместо условного e-mail указать символы, текст и т.д. и посмотреть, как сервер отреагирует на данные, которые он не ожидает увидеть. Это можно использовать в большом количестве ситуаций, всё зависит от вашего настроя и желания.</p><p>Спасибо за прочтение статьи. Рекомендую ознакомиться с предыдущими статьями на тему Postman:</p><ul><li>Postman — как инструмент тестирования API <a href="https://medium.com/effective-developers/postman-%D0%BA%D0%B0%D0%BA-%D0%B8%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82-%D1%82%D0%B5%D1%81%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F-api-6c0f76358cf2">https://medium.com/effective-developers/6c0f76358cf2</a></li><li>Postman — менеджмент, структурирование, импорт и экспорт коллекций <a href="https://medium.com/effective-developers/postman-%D0%BC%D0%B5%D0%BD%D0%B5%D0%B4%D0%B6%D0%BC%D0%B5%D0%BD%D1%82-%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%82%D1%83%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%B8%D0%BC%D0%BF%D0%BE%D1%80%D1%82-%D0%B8-%D1%8D%D0%BA%D1%81%D0%BF%D0%BE%D1%80%D1%82-%D0%BA%D0%BE%D0%BB%D0%BB%D0%B5%D0%BA%D1%86%D0%B8%D0%B9-125c6de936d7">https://medium.com/effective-developers/125c6de936d7</a></li></ul><p>Я надеюсь, эти статьи помогут тебе в дальнейшем развитии в тестировании API. Успехов!</p><p>Если вам нужно разработать качественное мобильное приложение или веб-сервис, смело обращайтесь к нам в Effective, мы готовы сотрудничать с вами в любом виде, как на проекте целиком так и на аутстаф — contact@effective.band</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lR8alCQncOOeG-Y7iEHNkg.jpeg" /></figure><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=a190a0a9617" width="1" height="1" alt=""><hr><p><a href="https://medium.com/effective-developers/postman-%D1%81%D0%BC%D0%B5%D0%BD%D0%B0-%D0%BE%D0%BA%D1%80%D1%83%D0%B6%D0%B5%D0%BD%D0%B8%D0%B9-%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0-%D0%B0%D0%B2%D1%82%D0%BE%D1%80%D0%B8%D0%B7%D0%B0%D1%86%D0%B8%D0%B8-%D0%B7%D0%B0%D0%BF%D1%80%D0%BE%D1%81%D0%BE%D0%B2-%D1%83%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0-%D0%BF%D0%B5%D1%80%D0%B5%D0%BC%D0%B5%D0%BD%D0%BD%D1%8B%D1%85-a190a0a9617">Postman. Смена окружений, настройка авторизации запросов,  установка переменных.</a> was originally published in <a href="https://medium.com/effective-developers">Effective</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Postman — менеджмент, структурирование, импорт и экспорт коллекций.]]></title>
            <link>https://medium.com/effective-developers/postman-%D0%BC%D0%B5%D0%BD%D0%B5%D0%B4%D0%B6%D0%BC%D0%B5%D0%BD%D1%82-%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%82%D1%83%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%B8%D0%BC%D0%BF%D0%BE%D1%80%D1%82-%D0%B8-%D1%8D%D0%BA%D1%81%D0%BF%D0%BE%D1%80%D1%82-%D0%BA%D0%BE%D0%BB%D0%BB%D0%B5%D0%BA%D1%86%D0%B8%D0%B9-125c6de936d7?source=rss-19e816ce3a00------2</link>
            <guid isPermaLink="false">https://medium.com/p/125c6de936d7</guid>
            <category><![CDATA[digital]]></category>
            <category><![CDATA[postman]]></category>
            <category><![CDATA[tools]]></category>
            <category><![CDATA[qa]]></category>
            <category><![CDATA[testing]]></category>
            <dc:creator><![CDATA[Alexander Kuvshinov]]></dc:creator>
            <pubDate>Wed, 13 Nov 2019 04:38:19 GMT</pubDate>
            <atom:updated>2020-04-02T07:46:32.788Z</atom:updated>
            <content:encoded><![CDATA[<h3>Postman — менеджмент, структурирование, импорт и экспорт коллекций.</h3><p>В <a href="https://medium.com/effective-developers/6c0f76358cf2">предыдущей статье</a> был рассмотрен инструмент для тестирования API — Postman. Эта статья посвящается организации коллекций, как экспортировать и импортировать коллекции.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*QOx_tPV5wJnhTzAGhfIiLA.png" /></figure><h3>Менеджмент коллекций</h3><p>Когда вы тестируете несколько проектов параллельно, чтобы избежать путаницы в списке запросов, логичнее всего будет создать коллекцию для каждого проекта. Важно разделить проекты именно на этапе создания запросов. В примере я создам три проекта и назову их “Test 1”, “Test 2” и “Test 3”.</p><ul><li>Создать новую коллекцию в Postman</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*9OK7Z2MP-YNSnyRY7gTfTg.png" /></figure><ul><li>Назвать эту коллекцию и опционально заполнить описание. <br><em>Совет! Используйте название тестируемого проекта.</em></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*TwW3a42Ua1lLMMUqVoXtPA.png" /><figcaption><em>После нажатия на кнопку “Create” коллекция создаётся</em></figcaption></figure><p>Скорее всего, когда вы будете создавать свою первую коллекцию, она будет одна. В примере я покажу сразу несколько проектов/коллекций, какую именно схему менеджмента коллекции выбрать — решать вам.</p><p>Итак, коллекция создана. Что дальше? При нажатии на пустую коллекцию, Postman сам подсказывает, что можно добавить запрос или создать папку.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*Yc7Xu9_gBEF2lZ8UrnaYSQ.png" /></figure><p>Создадим папку внутри коллекции.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*JkJ7R1BYcmc1lcM48WH8zw.png" /></figure><p>Тут начинается самое интересное. Как же назвать папку? Есть несколько способов организовать папки внутри коллекции:</p><p><strong>1) По функциональным блокам<br>2) По user flow <br>3) По версии API (V1, V2 и т.д.)<br>4) По критично важной функциональности</strong></p><h3>Организация коллекций по функциональным блокам</h3><p>Например, в приложении или на сайте есть следующие функциональности:</p><ul><li>Регистрация, авторизация, восстановление аккаунта</li><li>Каталог</li><li>Поддержка</li><li>Личный кабинет</li><li>Корзина</li></ul><p>и т.д до бесконечности.</p><p>Один из способов — разбить папки на функциональные блоки, чтобы облегчить проверку тех запросов, где произошли изменения, или регрессом проверять отдельные части приложения/веб-сервиса. Этот способ подходит в том случае, когда нужно держать под контролем абсолютно весь API и когда проект уже находится на стадии поддержки, но API еще не тестировался ранее.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*lDlAmlXPlUBUUCYDRVY8yQ.png" /><figcaption><em>Организация коллекций по функциональным блокам.</em></figcaption></figure><h3>Организация коллекций по user flow</h3><p>Папки можно организовать, подумав о наборе шагов, которые обычно проходит пользователь. Например: пользователь логинится, заходит в каталог, добавляет товар в корзину, переходит на оформление заказа, заполняет все данные, переходит к оплате… Это один из user flow пользователя, которых может быть большое количество. Еще пример — пользователь заходит в каталог, добавляет несколько позиций в избранное, проверяет, что в разделе “избранное” эти позиции остались. По таким сценариям и можно оформить папки. Этот вариант подходит, когда стоит задача проверить именно путь пользователя от входа в приложение до его конечной цели. Даже если его цель — поменять пароль, или посмотреть новые акции. На практике этот подход применяется достаточно редко, т.к. такие коллекции крайне специфичны.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*VEP8_IGAtLkn0yt0tm3NIw.png" /><figcaption><em>Пусть вас не смущает повторяющийся запрос “Логин”. В следующих статьях я расскажу как в каждом запросе не использовать логин с помощью предустановленного логина и расскажу больше о переменных в запросе.</em></figcaption></figure><h3>Организация коллекций по версии API</h3><p>Разработка веб-сервиса или приложения состоит из этапов. В случае, когда с клиентом существует договоренность в первом этапе сделать определённый набор функциональностей, таких как регистрация, авторизация, каталог, корзина, оформление заказа, оплата, уместно разбить коллекцию по версиям API, которые от этапа к этапу обновляются. Например API v1, API v2 (где добавятся акции, раздел избранного, бонусные программы), API v3 и т.д. Зачастую, это один из самых распространённых случаев, т.к. в основном тестирование API и создание коллекции в Postman происходит в самом начале разработки.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*31chlEB2DoOJhUnZrwoL1Q.png" /></figure><h3>Организация коллекций по критично важной функциональности</h3><p>Согласно теории тестирования программного обеспечения, невозможно обеспечить отсутствие дефектов в разрабатываемом продукте. Особенно в случае сжатых сроков (ну куда же мы без дедлайнов когда наш клиент внезапно хочет сделать демо своим клиентам, потому что его бизнес идея раскрутилась?). В таких случаях нам необходимо убедиться, что основные или наиболее часто используемые части продукта работоспособны и исправны. То есть мы выделяем критичную функциональность и фокусируемся только на ней. Можно использовать этот метод при проведении приёмки минорного релиза, либо для создания коллекции в Postman, где будет отдельная папка с критичной функциональностью. В этом случае тестирование займет меньше времени за счёт фокусировки на конкретной части продукта, дешевле для клиента, но при этом клиент не будет терять деньги из-за того, что фичи типа “сканер штрих-кода товара” или “редирект на сайт из приложения” работают, а оплата отвалилась, т.к. она проверяется намного чаще, потому что входит в скоуп критично важной функциональности.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*12w1QTV6EK3F5plJUESrqw.png" /></figure><h3>Экспорт</h3><p>Коллекция создана, формат коллекции удобен, вдруг менеджер проекта или другой QA спрашивает “А есть коллекция в постмане? Хочу тоже посмотреть”. Коллекция есть, и для того, чтобы поделиться коллекцией и существует экспорт, чтобы по несколько раз не делать разным людям в команде одну и ту же работу. Да, можно импортировать коллекцию из Swagger’a, но ведь не всегда в Swagger’e указаны нужные параметры и прочие необходимые вещи для успешного запроса. В этом и есть огромный плюс Postman’a. Можно создавать и хранить кастомизированные запросы на основе документации (указывать необходимые ID, предустанавливать токен пользователя и т.д.). В онлайн инструментах типа Swagger’a тоже можно кастомизировать параметры или тело запроса, но нельзя сохранить эти шаблоны для последующего использования.. Также, не у всех сервисов хранения документации по API есть экспорт, иногда это вообще простыня из запросов и методов.</p><p>Существует два способа экспорта: с помощью создания файла коллекции .json и по URL.</p><ol><li>Файлом .json:</li></ol><ul><li>Выбрать нужную коллекцию</li><li>Нажать на кнопку “меню” у названия коллекции (или правой кнопкой мыши нажать на коллекцию)</li><li>Выбрать пункт “Export”</li><li>В открывшемся меню выбрать нужную версию коллекции (лучше использовать 2.1, т.к. эта версия является более универсальной и наиболее используемой. Про версии коллекций можно больше узнать здесь: <a href="https://blog.getpostman.com/2015/06/05/travelogue-of-postman-collection-format-v2/?_ga=2.37629798.776407875.1573536003-336914111.1569392101">Postman blog</a>)</li><li>Нажать кнопку “Export”</li><li>Указать директорию, где будет храниться .json файл</li><li>Сохранить</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*NJNpP6YmuO86kuZ7CT-GLQ.gif" /></figure><p>Вы великолепны! Файл создан, можно его скидывать заинтересованным людям.</p><p>2. С помощью URL ссылки:</p><ul><li>Выбрать нужную коллекцию</li><li>Нажать на кнопку “Меню” у названия коллекции (или правой кнопкой мыши нажать на коллекцию)</li><li>Выбрать пункт “Share collection”</li><li>Включить вкладку “Get link”</li><li>Нажать на кнопку “Get link” для генерации ссылки</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*ieiW3QOkIDZIlJD8P3Rxrg.gif" /></figure><p>Готово! :) Ссылка получена, можно её скопировать и отправить кому нужно.</p><h3>Импорт</h3><p>Представим, что вы с другой стороны баррикады. С вами делятся файлом .json или ссылкой на коллекцию. Как этот файл открыть? Для этого существует импорт коллекций.</p><ol><li>Импорт с помощью файла .json:</li></ol><ul><li>Нажать на кнопку “Import” в левом верхнем углу</li><li>Выбрать вкладку “Import file”</li><li>Нажать на кнопку “Choose file” (либо просто драг-н-дропнуть .json файл в диалоговое окно с кнопкой “Choose file”)</li><li>Выбрать нужный файл</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*YxsCWrlWSo5itTqk0xzAaA.gif" /></figure><p>Вот и всё, коллекция добавлена и доступна в вашем списке коллекций.</p><p>2. Импорт с помощью сгенерированного URL:</p><ul><li>Нажать на кнопку “Import”</li><li>Выбрать вкладку “Import from link”</li><li>Ввести ссылку на коллекцию, сгенерированную при экспорте</li><li>Нажать на кнопку “Import”</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/1*PZ_Y9Ba7IAuIMc3exvhTOA.gif" /></figure><p>Теперь вы имеете представление о менеджменте коллекций и способах их экспорта и импорта. Конечно, можно вести коллекции так, как удобно вам. Материалы в этой статье лишь демонстрируют возможности организации коллекций и работы с ними. Зато теперь после вопроса “Скинь мне свою коллекцию”, вы не будете тратить время на то, чтобы разобраться как это сделать, ведь вы уже всё знаете!</p><p>В следующей статье будут рассмотрены предустановки для запросов, окружения, на которые будут отправляться запросы, предавторизация перед запросами, а также, коснемся темы инкремента значений в теле запроса.</p><p>Если вам нужно разработать качественное мобильное приложение или веб-сервис, смело обращайтесь к нам в Effective, мы готовы сотрудничать с вами в любом виде, как на проекте целиком так и на аутстаф — contact@effective.band</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=125c6de936d7" width="1" height="1" alt=""><hr><p><a href="https://medium.com/effective-developers/postman-%D0%BC%D0%B5%D0%BD%D0%B5%D0%B4%D0%B6%D0%BC%D0%B5%D0%BD%D1%82-%D1%81%D1%82%D1%80%D1%83%D0%BA%D1%82%D1%83%D1%80%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D0%B5-%D0%B8%D0%BC%D0%BF%D0%BE%D1%80%D1%82-%D0%B8-%D1%8D%D0%BA%D1%81%D0%BF%D0%BE%D1%80%D1%82-%D0%BA%D0%BE%D0%BB%D0%BB%D0%B5%D0%BA%D1%86%D0%B8%D0%B9-125c6de936d7">Postman — менеджмент, структурирование, импорт и экспорт коллекций.</a> was originally published in <a href="https://medium.com/effective-developers">Effective</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
        <item>
            <title><![CDATA[Postman — как инструмент тестирования API]]></title>
            <link>https://medium.com/effective-developers/postman-%D0%BA%D0%B0%D0%BA-%D0%B8%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82-%D1%82%D0%B5%D1%81%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F-api-6c0f76358cf2?source=rss-19e816ce3a00------2</link>
            <guid isPermaLink="false">https://medium.com/p/6c0f76358cf2</guid>
            <category><![CDATA[postman]]></category>
            <category><![CDATA[qa]]></category>
            <category><![CDATA[tools]]></category>
            <category><![CDATA[digital]]></category>
            <category><![CDATA[testing]]></category>
            <dc:creator><![CDATA[Alexander Kuvshinov]]></dc:creator>
            <pubDate>Wed, 25 Sep 2019 06:33:24 GMT</pubDate>
            <atom:updated>2020-04-02T07:46:48.458Z</atom:updated>
            <content:encoded><![CDATA[<h3>Postman — как инструмент тестирования API</h3><p>Я начинаю цикл ознакомительных и обучающих статей по Postman. Цель данного цикла — помочь новичкам овладеть этим инструментом и начать применять его в работе. Первая из статей будет вводная, в которой я расскажу для чего нужен Postman, как начать им пользоваться, а так же разберу несколько простых запросов.</p><p>В настоящее время, тестировщики достаточно часто сталкиваются с ситуацией, когда задача звучит следующим образом: “Протестируй апиху, пожалуйста, тебе бэкенднер документацию скинул”. В этот момент у многих может случиться ступор. Но опытные тестировщики сразу же подумают о Postman.</p><h3>Для чего нужен Postman?</h3><p>Postman предназначен для проверки запросов с клиента на сервер и получения ответа от бэкенда. Можно описать общение Postman с бэкендом в виде диалога:</p><p><strong>Postman</strong>: <em>“Дай мне информацию по балансу именно этого пользователя”<br> </em><strong>Backend</strong>: <em>“Да, конечно, запрос правильный, получи информацию по балансу этого пользователя”</em></p><p>Такой позитивный диалог происходит в том случае, если ошибок на бэкенде нет и разработчик сделал всё согласно документации. Но не всегда это происходит в таком успешном ключе. В моей практике случались следующие диалоги:</p><p><strong>Postman</strong>: <em>“Дай мне информацию по балансу именно этого пользователя”<br> </em><strong>Backend</strong>: <em>“Кто я вообще?”</em></p><p>или</p><p><strong>Postman</strong>: <em>“Дай мне информацию по балансу именно этого пользователя”<br> </em><strong>Backend</strong>: <em>“Пользователь не найден.”</em></p><p>Описанные выше ответы от бэкенда имеют свой код ошибки, которые приходят в ответе.</p><p>В первом случае — это ошибка с кодом <strong>500</strong> <em>(Internal Server Error)</em> внутренняя ошибка сервера, которая говорит о том, что сервер столкнулся с неожиданным условием, которое помешало ему выполнить запрос.</p><p>Во втором — <strong>404</strong> ошибка <em>(Not Found)</em> код ответа HTTP о том, что сервер не может найти данные по запросу, полученному от клиента.</p><p>Именно для этого и предназначен Postman — для проверки запросов клиент <strong>→</strong> сервер по документации, чтобы убедиться, что всё работает на стороне бэкенда.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/994/1*QfIceF_Xx9BSSZVLwXfOsw.png" /><figcaption>Стандартная схема взаимодействия клиента и сервера</figcaption></figure><h3>Как начать?</h3><p>Для начала — нужно скачать клиентское приложение с официального сайта — <a href="https://www.getpostman.com/">https://www.getpostman.com/</a>.</p><ul><li>Нужно нажать на кнопку <strong>“Download the App”</strong></li><li>Далее нужно выбрать свою ОС, скачать файл и установить его.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*wVh75XobgP7DduVm" /></figure><ul><li>После запуска программа предлагает создать запрос, коллекцию, среду, создать МОК-сервер и т.д. Но сегодня будет рассмотрена основная функциональность Postman — это как раз создание коллекций с запросами к API. Следовательно нужно выбрать <strong>“Collection”</strong></li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*EdkagS44A1T7eUSw" /></figure><ul><li>Далее нужно будет дать название своей коллекции. Например, это может быть название тестируемого проекта. В моём случае пример одного из запросов будет из <a href="https://docs.postman-echo.com/?version=latest">Postman Echo</a>, открытой документации от разработчиков Postman.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*Voi74s4cTH4qxaIV" /><figcaption>Интерфейс программы</figcaption></figure><ol><li>Созданная коллекция, которая называется “POSTMAN ECHO”</li><li>Вкладка с запросом</li><li><a href="https://ru.wikipedia.org/wiki/HTTP#%D0%9C%D0%B5%D1%82%D0%BE%D0%B4%D1%8B">Метод</a>, который будет использован для запроса</li><li>URL адрес</li><li>Кнопка отправки запроса</li><li>Параметры запроса</li><li>Параметры ответа</li></ol><h3>Как пользоваться?</h3><p>Итак, есть документация, есть Postman, коллекция создана. Что дальше?</p><p>Все виды документации по API выглядят примерно одинаково. В любом из видов можно увидеть какой метод нужно использовать, какой URL, какие body, params headers и так далее.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*hz1qK9Mn2mIlDi5p" /><figcaption>Пример документации “Postman echo”.</figcaption></figure><ol><li>В левой части функциональные блоки API, разделённые по категориям (Регистрация, логин, личный кабинет с данными, получение контента и т.д).</li><li>По центру находится информация о том, какой метод нужно использовать, URL для отправки запроса, параметры, которые нужно передавать в теле запроса.</li><li>Справа — ответы, которые должны приходить с сервера.</li></ol><p>Всё готово, можно отправить первый запрос! Пример запроса будет показан на запросе “GET request” из общедоступной документации postman echo. Метод GET нужен для получения какой-либо информации от сервера.</p><ul><li>Во-первых, нужно выбрать метод, который будет использован. В примере используется метод “GET”, его и нужно выбрать в Postman.</li><li>В поле ввода URL нужно ввести также URL, который находится в центральной части документации: “<a href="https://postman-echo.com/get?foo1=bar1&amp;foo2=bar2">https://postman-echo.com/get?foo1=bar1&amp;foo2=bar2</a>”</li></ul><p>В данном примере через URL уже переданы параметры запроса, а именно: “<a href="https://postman-echo.com/get?foo1=bar1&amp;foo2=bar2">foo1=bar1&amp;foo2=bar2</a>”. При вставке URL в поле для ввода URL, автоматически подставляются параметры запроса в вкладку “Params”:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*2jHjHxRbAhoUyoit" /><figcaption>Params автоматически подставились при вводе URL</figcaption></figure><p>После того, как выбран метод, указан URL и параметры, можно отправить запрос на сервер. После нажатия кнопки “Send” в параметре ответа появляется ответ от сервера.</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*ZrmFmXxo_yRfUe_h" /></figure><p>Метод работает, данные приходят верные, валидные, всё получилось.</p><p>Рассмотрим другой метод: POST, который нужен для передачи каких-либо данных с клиента на сервер. <br>Для данного типа запросов можно воспользоваться <a href="https://jsonplaceholder.typicode.com/posts">https://jsonplaceholder.typicode.com/posts</a> в качестве URL запроса. Это открытый сервис, который можно использовать для имитации работы сервера.</p><p>Всё так же, как и при предыдущем методе, только меняется немного параметр запроса:</p><ul><li>Нажать на иконку “+” для создания новой вкладки запроса. При создании новой вкладки, Postman предложит сохранить предыдущий запрос “GET” в коллекцию.</li><li>На новой вкладке нужно выбрать метод “POST” вместо “GET”.</li><li>В поле для ввода URL ввести <a href="https://jsonplaceholder.typicode.com/posts">https://jsonplaceholder.typicode.com/posts</a></li><li>Перейти на вкладку “Body” в вкладках параметров запроса. Это параметр тела запроса, т.е. что именно будет отправлено на сервер.</li><li>Внутри “Body” нужно сменить тип на “raw” и справа сменить “Text” на “JSON”. Обычно, в грамотно составленной документации, все необходимые параметры Params, Headers, Body прописаны и указано в каком формате эти данные должны быть переданы.</li><li>Вставить следующий запрос в текстовый редактор, который появился при выборе типа “raw” и “JSON”:</li></ul><p>{</p><p>“title”: “First POST request”,</p><p>“body”: “I hope, it’s gonna be work”,</p><p>“userId”: 12345</p><p>}</p><p>Должно всё выглядеть следующим образом:</p><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*yugB5WngTqfR4t7C" /><figcaption>Созданы все условия для отправки запроса.</figcaption></figure><ul><li>После ввода Body, нажать на кнопку “Send”.</li></ul><figure><img alt="" src="https://cdn-images-1.medium.com/max/1024/0*9tpDgbW_sqlLSym1" /></figure><p>В ответе должен прийти текст, который был отправлен в текстовом редакторе из Body, к которому добавится id новой записи, которая была создана на сервере. Также код “201 Created” подтверждает то, что новая запись была создана.</p><p>В этой статье были рассмотрены два самых популярных запроса при тестировании API. Метод GET — получить что-либо с сервера, метод POST — отправить что-либо на сервер и увидеть, что данные были отправлены и приняты. Все остальные методы работают по похожему принципу, главное — внимательно читать документацию и всегда указывать нужные Params, Body, URL и метод, которые нужны для успешного запроса. Спасибо за внимание!</p><p>В следующей статье будет рассмотрен менеджмент, структурирование, импорт и экспорт коллекций и запросов.</p><p>Если вам нужно разработать качественное мобильное приложение или веб-сервис, смело обращайтесь к нам в Effective, мы готовы сотрудничать с вами в любом виде, как на проекте целиком так и на аутстаф — contact@effective.band</p><img src="https://medium.com/_/stat?event=post.clientViewed&referrerSource=full_rss&postId=6c0f76358cf2" width="1" height="1" alt=""><hr><p><a href="https://medium.com/effective-developers/postman-%D0%BA%D0%B0%D0%BA-%D0%B8%D0%BD%D1%81%D1%82%D1%80%D1%83%D0%BC%D0%B5%D0%BD%D1%82-%D1%82%D0%B5%D1%81%D1%82%D0%B8%D1%80%D0%BE%D0%B2%D0%B0%D0%BD%D0%B8%D1%8F-api-6c0f76358cf2">Postman — как инструмент тестирования API</a> was originally published in <a href="https://medium.com/effective-developers">Effective</a> on Medium, where people are continuing the conversation by highlighting and responding to this story.</p>]]></content:encoded>
        </item>
    </channel>
</rss>