atesting.ru Блог Учебник Postman для начинающих: тестирование API с помощью Postman

Учебник Postman для начинающих: тестирование API с помощью Postman

Учебник почтальона для Новички: тестирование API с помощью Postman

В этом руководстве по Postman мы рассмотрим, как мы подходим к тестированию API с помощью Postman для любого заданного URL-адреса для вашей повседневной работы.

Будучи изначально плагином для браузера Chrome, Postman теперь расширяет свое решение нативной версией как для Mac, так и для Windows.

 Учебник Postman для начинающих: тестирование API с помощью Postman

Что такое API?

API — это аббревиатура, обозначающая приложение P программирования I интерфейса. API — это набор процедур, протоколов и инструментов для создания программных приложений. API определяют, как одна программа должна взаимодействовать с другой программой.

Проще говоря, API означает A приложение P программирование I интерфейс. API действует как интерфейс между двумя программными приложениями и позволяет двум программным приложениям взаимодействовать друг с другом. API — это набор программных функций, которые могут выполняться другой программой.

Что такое Postman?

< p> Postman — это платформа для совместной работы по разработке API. Это популярный клиент API, который позволяет разрабатывать, создавать, публиковать, тестировать и документировать API.

Используя инструмент Postman, мы можем отправлять HTTP-запросы службе, а также получать их ответы. Таким образом мы можем убедиться, что служба запущена и работает.

Будучи изначально плагином для браузера Chrome, Postman теперь расширяет свое решение нативной версией как для Mac, так и для Windows.

Почему почтальон?

Почтальон стал любимым инструментом более 8 миллионов пользователей.

  • Бесплатно: его можно загрузить и использовать для команд любого размера.
  • Просто: просто скачайте его и отправьте свой первый запрос в считанные минуты.
  • Поддержка API: Вы можете выполнить любой вызов API (REST, SOAP или простой HTTP) и легко проверить даже самые большие ответы.
  • Расширяемый: вы можете настроить его в соответствии с вашими потребностями с помощью Postman API.
  • Интеграция. Вы можете легко интегрировать тестовые наборы в предпочитаемую вами службу CI/CD с помощью Newman (средство запуска коллекции командной строки).
  • Сообщество & amp; Поддержка: у него есть огромный форум сообщества.

Установка почтальона:

Проверьте здесь

Мы успешно установили приложение Postman. Теперь приступим к тестированию API с помощью Postman.

Postman — хороший выбор для тестирования API для тех, кто не хочет заниматься кодированием в интегрированной среде разработки, использующей тот же язык, что и разработчики.

Возможности Postman:

Ниже перечислены некоторые функции, предлагаемые инструментом Postman.

  • Простой в использовании клиент REST
  • Богатый интерфейс, упрощающий использование.
  • Может использоваться как для ручного, так и для автоматического тестирования API.
  • Может работать на Mac, Windows, Linux & amp; Приложения Chrome
  • Имеет множество интеграций, таких как поддержка Swagger & amp; Форматы RAML.
  • Имеет функции запуска, тестирования, документирования и мониторинга.
  • Не требует изучения нового языка.
  • Позволяет пользователям легко делиться знаниями с командой поскольку они могут упаковать все запросы и ожидаемые ответы, а затем отправить своим коллегам.
  • Может быть интегрирован с инструментами CI-CD, такими как Jenkins, TeamCity и т. д.
  • Поставляется с подробной документацией по API.
  • Разработка и разработка API; Автоматизация выполнения тестов API

Веб-сайт: https://www.getpostman.com/

Стоимость: бесплатно — 21 доллар США за пользователя в месяц

Это бесплатный инструмент. Его бесплатной версии более чем достаточно для выполнения основных требований тестирования API.

Как использовать Postman

Все компоненты в инструменте Postman имеют свое значение. Давайте теперь посмотрим на различные варианты рабочего пространства Postman.

 Руководство почтальона для начинающих: тестирование API с помощью почтальона

1. Новое: необходимо создать новый запрос, коллекцию или среду.
2. Импорт: импорт коллекции или среды. Вы также можете найти другие варианты, такие как импорт из файла, папки, ссылки или вставка сырого теста.
3. Runner: мы можем выполнять тесты автоматизации с помощью Collection Runner.
4. Открыть новое: мы можем открыть окно почтальона или окно бегуна
5. Мое рабочее пространство: это ваше рабочее место. Используя это, вы можете создать новое рабочее пространство. Рабочая область — это общий контекст для создания и использования API. Это позволяет сотрудничать в режиме реального времени внутри команд и между ними.
6. Пригласить: это приглашение членов вашей команды для совместной работы над рабочим пространством.
7. История: автоматическое сохранение запросов и ответов в истории, что помогает легко отслеживать свои прошлые действия.
8. Коллекции: это для организации и отслеживания связанных запросов.
9. Вкладка запроса: заголовок запроса, над которым вы работаете. По умолчанию он называется «Запрос без названия».
10. HTTP-запрос: вы можете видеть такие запросы, как GET, POST, COPY, DELETE и т. Д.
11. URL-адрес запроса: здесь мы упоминаем ссылку, по которой API будет взаимодействовать. Он также известен как конечная точка.
12. Сохранить: чтобы сохранить запрос или обновить существующий запрос.
13. Params: мы упоминаем параметры (ключевые значения), необходимые для запроса.
14. Авторизация: API-интерфейсы используют авторизацию, чтобы гарантировать, что клиент запрашивает доступ к данным безопасно. Здесь мы упоминаем детали авторизации, такие как имя пользователя, пароль, токен на предъявителя и т. Д.
15. Заголовки: некоторые API-интерфейсы требуют, чтобы вы отправляли определенные заголовки, такие как JSON, JavaScript и т. Д., Вместе с запросами, как правило, для предоставления дополнительных метаданных о выполняемой вами операции. Вы можете установить их здесь
16. Тело: позволяет указать данные, которые необходимо отправить с запросом. Вы можете отправлять различные типы данных тела в соответствии с вашим API.
17. Сценарий предварительного запроса: сценарии предварительного запроса написаны на JavaScript и запускаются перед отправкой запроса. Это идеально подходит для таких случаев, как включение отметки времени в заголовки запроса или отправка случайной буквенно-цифровой строки в параметрах URL.
18. Тесты. Тесты — это скрипты, выполняемые во время запроса. Тесты позволяют убедиться, что ваш API работает должным образом, установить надежность интеграции между службами и убедиться, что новые разработки не нарушили никаких существующих функций.

Строительные блоки Postman:

Перед тестированием API сначала мы увидим некоторые строительные блоки Postman Tool, которые необходимы для каждой операции Postman.

  1. Запросы
  2. Коллекции
  3. Среда

1. Запросы:

Запрос представляет собой комбинацию URL-адреса, заголовков HTTP, тела или полезной нагрузки. В инструменте почтальона вы можете сохранять свои запросы и использовать их в будущем в соответствии с вашими потребностями.

Нажмите Создать — Запрос

 Руководство почтальона для начинающих: тестирование API с помощью Postman

Руководство почтальона для начинающих: API Тестирование с использованием Postman

 Руководство Postman для начинающих: тестирование API с помощью Postman

Вы можете делать запросы к API в Postman. Запрос API позволяет получать данные из источника данных или отправлять данные. API-интерфейсы работают на веб-серверах и предоставляют конечные точки для поддержки операций, которые клиентские приложения используют для обеспечения своей функциональности.

Каждый запрос API использует метод HTTP.

Что такое HTTP?

HTTP означает протокол передачи гипертекста. HTTP обеспечивает связь между клиентами и серверами. Клиентами часто являются веб-браузеры, а серверами — компьютеры в облаке.

Если клиент отправляет HTTP-запрос на сервер, то сервер возвращает клиенту ответ. Ответ, отправленный сервером, содержит информацию о статусе запроса и запрошенном содержимом.

Наиболее часто используемые методы HTTP:

1. GET: метод GET используется для получения данных из API.
2. POST: метод POST используется для отправки новых данных в API
3. PUT: метод PUT используется для обновления существующих данных
4. PATCH: метод PATCH используется для обновления существующих данных
5. DELETE: метод DELETE используется для удаления существующих данных.

Теперь давайте посмотрим, как создать простой запрос с помощью приложения Postman, а также рассмотрим различные компоненты запроса и его ответа.

< p> Примечание. Здесь я использую этот Fake Online REST API для тестирования и прототипирования

2. Коллекции:

Коллекции — это группа сохраненных запросов, которые можно организовать в папки. Мы можем назвать это хранилищем для сохранения наших запросов.

Как создавать коллекции в Postman:

Нажмите Новая коллекция

 Учебник почтальона для начинающих: тестирование API с помощью Postman

Введите название коллекции и описание, затем нажмите» Создать «, чтобы создать новая коллекция

Руководство почтальона для начинающих: API Тестирование с помощью Postman

Вы можете добавить любое количество запросов в Коллекцию. Вы можете запускать коллекции в Postman двумя способами. 1. Использование Collection Runner & amp; 2. Использование Ньюмана. Перед закрытием этого поста мы увидим запуск коллекций с помощью Collection runner и Newman.

Теперь рассмотрим третий строительный блок, то есть среду.

3. Окружающая среда:

Среды в Postman позволяют нам запускать запросы и коллекции для разных наборов данных. У нас могут быть разные среды для Dev, QA и amp; Производство. Каждая из этих сред будет иметь разные конфигурации, такие как URL, идентификатор и пароль токена, ключи API и т. Д. Среды представляют собой пары переменных «ключ-значение». Каждое имя переменной представляет свой ключ. Поэтому всякий раз, когда мы ссылаемся на имя переменной, это позволяет нам получить доступ к соответствующему значению.

Чтобы создать новую среду, мы делаем следующее

Нажмите New — Окружающая среда

«Учебник

 Учебник Postman для начинающих: тестирование API с помощью Postman

Давайте посмотрим, как параметризовать запросы после того, как мы увидим, как тестировать запросы получения и отправлять запросы

Тестирование запросов получения:

Мы должны использовать запрос GET для получения информации по заданному URL-адресу. С запросами Get это не повлияет на конечную точку.

Откройте приложение Postman

Я рекомендую вам войти в приложение Postman, чтобы сохранить все ваши действия, такие как запросы , коллекции и т. д. для использования в будущем. Если вы не вошли в систему, войдите с соответствующими учетными данными.

Вот начальный экран интерфейса почтальона.

Шаг 1. Щелкните вкладку Создать , чтобы создать новый запрос.

< img class = "aligncenter" src = "/wp-content/uploads/2021/10/postman-tutorial-for-beginners-api-testing-using-postman-7c42ac4.png" alt = "Руководство почтальона для начинающих: тестирование API using Postman "/>

Шаг 2: Создание запроса GET для конечной точки REST API

  1. Установите для HTTP-запроса значение GET
  2. Введите ссылку в запросе URL (https://jsonplaceholder.typicode.com/users)
  3. Нажмите ОТПРАВИТЬ , чтобы выполнить запрос к серверу, на котором размещена конечная точка.
  4. Вы можете увидеть Сообщение 200 OK на скриншоте ниже, потому что наш запрос был успешным. В некоторых случаях запросы GET могут быть неудачными из-за неверного URL-адреса запроса или неправильной аутентификации.

https://jsonplaceholder.typicode.com/users

Вы должны увидеть различные данные вокруг ответа после того, как сервер ответит в разделе Body

На приведенном выше снимке экрана под заголовками запроса мы можем увидеть код состояния ответа, время, затраченное на выполнение запроса, размер полезной нагрузки

Мы можем найти подробную информацию о времени ответа и размере ответа, наведя указатель мыши. над ними.

Время отклика: мы можем видеть отдельные компоненты, такие как время подключения, время сокета, поиск DNS и т. д.

Руководство почтальона для начинающих: API Тестирование с помощью Postman

Размер ответа: мы можем видеть отдельные компоненты, такие как фактический размер ответа, размер заголовков и т. Д.

Руководство почтальона для начинающих: API Тестирование с помощью Postman

Файлы cookie: Мы можем найти информацию о сеансе в файлах cookie, которые были возвращены сервером.

 Руководство почтальона для начинающих: тестирование API с помощью Postman

Заголовок ответа: Здесь мы можем найти информация о запросе, который был обработан.

Руководство почтальона для начинающих: API Тестирование с помощью Postman

Тестирование запросов на публикацию:

Почтовые запросы используются для манипулирования данными путем добавления данных в конечную точку. Теперь давайте добавим пользователя в приложение. Для этого нам нужно отправить данные в приложение. Мы используем POST-запрос для отправки данных. В запросе POST мы отправляем данные в теле запроса, и API возвращает некоторые данные в ответ на запрос POST, который подтверждает, что пользователь был создан. Мы используем те же данные, которые использовали в запросе GET для добавления нового пользователя.

  1. Установите для HTTP-запроса значение POST
  2. Введите ссылку в запросе URL (https://jsonplaceholder.typicode.com/users)
  3. Щелкните вкладку Body и выберите « Raw ”- выберите JSON — скопируйте и вставьте только один результат пользователя из предыдущего запроса на получение, как показано на снимке экрана ниже.

    1234567891011121314151617181920212223 {& # 34; id & # 34 ;: 11, & # 34; name & # 34 ;: & # 34; Rajkumar SM & # 34; & # 34; имя пользователя & # 34 ;: & # 34; stm & # 34 ;, & # 34; электронная почта & # 34 ;: & # 34; [email protected]" & # 34; адрес & # 34 ;: {& # 34; улица & # 34 ;: & # 34; X Roads & # 34 ;, & # 34; люкс & # 34 ;: & # 34; кв. 007 & # 34 ;, & # 34; город & # 34 ;: & # 34; Хайдарабад & # 34 ;, & # 34; почтовый индекс & # 34 ;: & # 34; 600007 & # 34 ;, & # 34; geo & # 34 ;: {& # 34; широта & # 34 ;: & # 34; 10.0000 & # 34 ;, & # 34; lng & # 34 ;: & # 34; 80.0000 & # 34; }}, & # 34; phone & # 34 ;: & # 34; 1-2345-6-7890 & # 34 ;, & # 34; website & # 34 ;: & # 34; softwaretestingmaterial.com & # 34 ;, & # 34 ; company & # 34 ;: {& # 34; name & # 34 ;: & # 34; Материалы для тестирования программного обеспечения & # 34 ;, & # 34; catchPhrase & # 34 ;: & # 34; Блог для тестировщиков программного обеспечения & # 34 ;, & # 34; bs & # 34 ;: & # 34; уроки в реальном времени & # 34; }}
  4. Нажмите ОТПРАВИТЬ , чтобы выполнить запрос к серверу, на котором размещена конечная точка.

Примечание: вы можете использовать Jsonformatter, чтобы проверить правильный формат данных, которые вы пытаетесь опубликовать.

«Учебник

  1. Вы можете увидеть 201 Созданное сообщение на снимке экрана ниже, потому что наш запрос выполнен успешно.
  2. Вы можете видеть опубликованные данные в теле.

Руководство почтальона для начинающих: API Тестирование с помощью Postman

Аналогичным образом мы протестируем другие запросы PUT, PATCH & amp; УДАЛИТЬ

Примечание. Для каждого запроса нужно проверять ожидаемый результат, код состояния, время ответа. Также не забудьте провести отрицательные тесты, чтобы проверить, правильно ли отвечает API

Как параметризовать запросы:

Если мы хотим параметризовать запросы почтальона, нам нужно сделать следующее.

Параметризация данных — одна из самых полезных функций почтальона.

Часто мы используем один и тот же запрос несколько раз с разными данными. Используя параметризацию, мы можем использовать переменные с параметрами. Мы можем сохранить данные в переменной среды или в файле данных.

В Postman для параметров используются двойные фигурные скобки: «{{test}}»

Например, у меня есть базовый URL , например https://stm.org , и я сохранил в переменной с именем base_url . В этом случае я ссылаюсь на него в своих запросах, используя {{base_url}} . Чтобы отправить запрос на этот базовый URL (например, https://stm.org ) для получения списка новых клиентов, я указываю этот базовый URL как часть запросить URL с помощью {{base_url}}/get? customers = new . Запрос будет отправлен почтальоном на https://stm.org/get?customers=new .

1. Установите HTTP-запрос на GET и введите URL-адрес

 Руководство почтальона для начинающих: тестирование API с помощью Postman

2. Замените URL-адрес параметром, например {{url}} . URL-адрес запроса должен быть {{url}}/users .

Руководство почтальона для начинающих: API Тестирование с помощью Postman

3. Теперь нам нужно установить переменные среды для установки параметров. Для этого щелкните значок глаза и щелкните «Изменить», чтобы установить для переменной глобальную переменную среды, чтобы использовать ее во всех коллекциях

Руководство почтальона для начинающих: API Тестирование с помощью Postman

4. В переменной задайте имя URL-адреса https://jsonplaceholder.typicode.com и нажмите «Сохранить».

 Руководство почтальона для начинающих: тестирование API с помощью Postman

Примечание. Нажмите» Закрыть «, если вы см. следующий экран

5. Вернитесь к запросу GET и нажмите кнопку «Отправить».

Руководство почтальона для начинающих: API Тестирование с помощью Postman

Как создать тесты Postman:

Тесты Postman Tests позволяют убедиться, что ваш API работает должным образом. Это необходимо для обеспечения надежного функционирования интеграции между сервисами и для проверки того, что новые разработки не нарушили какие-либо существующие функциональные возможности. Он помогает вам проверять такие результаты, как успешный или неудачный статус, сравнение ожидаемых результатов и т. Д.

Давайте начнем с некоторых основных тестов.

1. Переходим к GET-запросу, который мы создали ранее. и переключитесь на вкладку тестов. В разделе фрагментов нажмите «Код состояния: код 200». Скрипт будет заполнен автоматически.

Руководство почтальона для начинающих: API Тестирование с помощью Postman

2. Щелкните Отправить. Результат будет отображен.

Учебник Postman для начинающих: тестирование API с помощью Postman

3. Давайте добавим еще один тест. В этом тесте мы сравниваем ожидаемый результат с фактическим результатом. Для этого нажмите «Тело ответа: проверка значения JSON» в разделе фрагментов. Давайте проверим, есть ли у Линн Грэм идентификатор пользователя 1.

 Руководство почтальона для начинающих: тестирование API с помощью почтальона

4. Чтобы точно указать имя теста, которое мы хотим протестировать, просто замените «Имя вашего теста» в коде на «Проверить, есть ли у Линн Грэм идентификатор пользователя 1». Также замените jsonData.value на jsonData [0] .name. Чтобы получить путь (он есть в теле результата GET ранее). Поскольку «Leanne Graham» — идентификатор пользователя 1, jsonData находится в первом результате, который должен начинаться с 0. Чтобы получить второй результат, используйте jsonData [1] и так далее для последующих результатов.

Руководство почтальона для начинающих: тестирование API с помощью Postman

1234 pm.test (& # 34; Проверить, является ли пользователь с id1 Линн Грэм & # 34 ;, function () {var jsonData = pm.response.json (); pm.expect (jsonData [0] .name) .to.eql (& # 34; Линн Грэм & # 34;);});

5. Нажмите «Отправить».

 Учебник Postman для начинающих: тестирование API с помощью Postman

Мы можем создавать тесты в зависимости от наших требований. Изучите инструменты, попробовав различные тесты.

Как запускать коллекции с помощью Collection Runner:

Давайте запустим коллекцию с помощью collection бегун

1. Нажмите кнопку Runner, расположенную рядом с кнопкой Import.

«Учебник

2. Должна появиться страница Collection Runner

Руководство почтальона для начинающих: API Тестирование с помощью Postman

  • 1. Все недавние прогоны
  • 2. Если вы используете определенную среду, вам нужно выбрать эту среду.
  • 3. Вы должны установить число в зависимости от того, сколько раз вы хотите его повторить.
  • 4. Тесты без задержки могут вызвать ошибки, поэтому установите время задержки
  • 5. Укажите, как вы хотите регистрировать ответы.
  • 6. Выберите файл данных.
  • 7. Для запуска коллекции

3. Вы можете добавить сюда избранную коллекцию. Вы должны выбрать подпапку, если какие-либо подпапки доступны. Запустите сборник тестов почтальона, установив итерацию как 2, задержку как 2500 мс, и нажмите кнопку «Запустить тест почтальона».

Руководство почтальона для начинающих: API Тестирование с помощью Postman

4. Вы можете увидеть статус теста после того, как тесты будут выполнены. Здесь мы добавили как GET, так и amp; Запросы POST, но у нас не было запросов POST. Таким образом, вы видите сообщение для запросов POST: «Этот запрос не содержит тестов».

 Учебник Postman для начинающих: тестирование API с помощью Postman

Как запускать коллекции с помощью Newman:

Чтобы запустить нашу коллекцию с помощью Newman, сделайте следующее.

1. Установите node.js по этой ссылке

2. Откройте командную строку и введите npm install -g newman

3. После установки Newman перейдите в рабочее пространство Postman. В поле коллекций щелкните три точки и выберите «Экспорт».

Руководство почтальона для начинающих: API Тестирование с помощью Postman

4. Выберите «Экспортировать коллекцию как коллекцию v2.1» (рекомендуется), затем нажмите «Экспорт».

 Учебное пособие по Postman для начинающих: тестирование API с помощью Postman

5. Выберите желаемое место и нажмите «Сохранить». Желательно создать специальную папку для ваших тестов Postman. Теперь коллекция должна быть экспортирована в выбранный вами локальный каталог.

6. Нам также нужно будет экспортировать нашу среду. Щелкните значок глаза рядом с раскрывающимся списком среды в Global и выберите Загрузить как JSON. Выберите желаемое место и нажмите «Сохранить». Желательно, чтобы среда находилась в той же папке, что и ваша коллекция.

Руководство почтальона для начинающих: API Тестирование с использованием Postman

 Руководство Postman для начинающих: тестирование API с помощью Postman

7. Окружение теперь должно быть экспортировано в тот же локальный каталог, что и Коллекция.

8. Теперь вернитесь в командную строку и перейдите в каталог, в котором вы сохранили коллекцию и среду.

cd C: Users Asus Desktop Postman Tutorial

9. Запустите свою коллекцию с помощью этой команды:

newman run PostmanTestCollection.postman_collection.json -e Testing.postman_globals.json

Run должны появиться результаты.

Заключение:

В этом руководстве почтальона для начинающих мы рассмотрели самые важные темы. Надеюсь, вы научились устанавливать почтальон и создавать простые запросы, проверять время ответа и другие детали, а также научились запускать коллекции с помощью Collection Runner & amp; Новый человек. В следующем посте мы рассмотрим расширенные темы инструмента «Почтальон».

Расширенное руководство для почтальона

Мы также рассмотрели расширенные темы инструмента Postman для тестирования API.

  • Тестовые примеры API в Postman с использованием JavaScript

  • Как генерировать случайные/динамические данные в запросах
  • Как извлечь данные из ответов & amp; Сцепление запросов
  • Проверка авторизации OAuth2 в Postman
  • Как отправить веб-токен JSON (JWT) в качестве заголовка
  • Проверка схемы JSON в Postman
  • Тестирование на основе данных в Postman
  • Монитор Коллекции в Postman
  • Как запускать коллекции удаленно (с URL-адресом) в Postman
  • Как запускать коллекции из Jenkins
  • Как отлаживать запуск коллекции в Postman
  • Как создавать отчеты Ньюмана о Дженкинсе
  • Как создавать расширенные отчеты HTML с помощью Ньюмана
  • Как исправить распространенные ошибки в Postman
  • GUID в Postman (Что | Преимущества | Недостатки)
  • Документация по API в Postman

TAG: qa