Презентация - "Тестирование API. Введение в Postman."

Введение в Postman

Что такое API?
API — сокращение от Application Programming Interface (программный интерфейс приложения).
API — набор правил, протоколов и инструментов для взаимодействия между приложениями.
Говоря простым языком, API — интерфейс, который определяет, как одна программа должна взаимодействовать с другой программой. Как правило, представляет собой набор функций, которые могут быть вызваны другой программой.

Что такое Postman?
Postman — приложение для работы с API. Это популярный API клиент, который позволяет разрабатывать, тестировать и документировать API.
Как тестировщики, с помощью Postman мы можем отсылать HTTP/s запросы к сервисам и получать от них ответы. С помощью такого подхода можно протестировать бэкенд сервисы и убедиться, что они корректно работают.

Почему Postman?
Сегодня Postman — супер-популярный инструмент.
Им пользуются более 8 миллионов разработчиков и тестировщиков.
Бесплатный.
Простой в использовании.
Поддерживает разные API. С помощью Postman можно выполнять разные типы запросов к любым API.
Расширяемый. Postman можно настроить под ваши конкретные нужды с помощью Postman API.
Имеет большое комьюнити. Postman очень популярный и, как следствие, имеет большое комьюнити, которое подскажет ответы на большинство вопросов.

Установка Postman
Ccылка для скачивания Postman:
https://www.postman.com/downloads/
Также у Postman есть web версия, которая работает прямо в браузере.
https://identity.getpostman.com/login

Интерфейс Postman
Верхнее меню дает возможность создания рабочего пространства (Workspaces) и доступа к различным api (API Network). Также с его помощью можно делать поиск. Home - содержит вашу домашнюю страницу. На ней можно посмотреть вашу недавнюю активность. С помощью Workspaces - можно создать новое рабочее пространство, выбрать одно из недавно посещенных, либо сделать поиск по существующим.

Основные сущности Postman
Основные сущности, которыми оперирует Postman:
Запросы
Коллекции
Окружения

Запросы (Requests)
Запрос представляет собой комбинацию URL, хедеров и Body (тела запроса).
Postman позволяет сохранять запросы и использовать их в будущем там, где вам нужно.
Чтобы создать новый запрос, нажмите New — HTTP Request
Для каждого API-запроса нужно выбрать HTTP-method.

Запросы (Requests)
После отправки клиентом HTTP-запроса, сервер возвращает ответ. Ответ сервера содержит метаданные о статусе и запрашиваемый контент.
Наиболее распространенные типы HTTP-запросов:
GET: GET-запросы используются для получения данных от API.
POST: POST-запросы используются для отправки новых данных API.
PUT: PUT-запросы используются для обновления уже существующих данных.
PATCH: PATCH-запросы (как и PUT) используются для обновления уже существующих данных. Разница в том, что с помощью PATCH запросов можно обновить несколько записей за раз.
DELETE: DELETE-запросы используются для удаления существующих данных.

Коллекции (Collections)
Коллекции представляют собой группы запросов. Вы можете думать о коллекциях как о папках, в которых лежат запросы.
Для создания коллекции в Postman нажмите New — Collection
Коллекция может содержать любое число запросов.
Запустить выполнение коллекции можно двумя способами:
с помощью Collection Runner
c помощью Newman

Окружение (Environments)
Окружения в Postman позволяют запускать запросы и коллекции, используя разные наборы данных.
Например, мы можем создавать разные окружения в Postman для Dev, QA и Production серверов.
В каждом из окружений будут свои собственные настройки: например, URL, auth token-ы и пароли, API-ключи и т.п.
Окружения представляют собой наборы пар «ключ-значение».
Чтобы создать новое окружение (Environment), нажмите New — Environment

Пример создания запросов
Для обучения будем использовать простой открытый API: https://jsonplaceholder.typicode.com/users
Отправим GET-запрос с помощью Postman:
Шаг 1: Создаем новый запрос:

Пример создания запросов
Шаг 2: Создаем GET-запрос:
Задаем тип запроса — GET
Задаем request URL — https://jsonplaceholder.typicode.com/users
Нажимаем на кнопку SEND, чтобы выполнить запрос.
Вы увидите 200 OK в результате, если запрос выполнится успешно.
Бывают случаи, когда GET-запросы выполняются с ошибками (например, при неправильном URL, некорректными авторизационными данными или из-за ошибок на стороне сервера)
После выполнения запроса вы должны будете увидеть данные от сервера во вкладке Body.

На скриншоте ниже вы видите код ответа сервера, время выполнения запроса и размер ответа.
Время ответа сервера (Response Time)

Пример создания запросов
Размер ответа (Response Size)
Тело ответа
Хедеры ответа от сервера (Response headers)

Формат обмена данными JSON
Тело ответа на запрос обычно приходит в формате JSON.
Например, информация про некоторый телефон в формате JSON будет выглядеть следующим образом:
{
“Name”: “NL920”,
“Brand”: “Nokia”,
“Model”: “Lumia 920”,
“OSFamily”: “Windows”,
“OSVersion”: “8”
}
Поле «Name» содержит имя (ключ) документа.
Информация обо всех телефонах будет представлена как совокупность документов, описывающих телефоны :
{
“Brand”: “Nokia”,
“Model”: “Lumia 920”,
“OSFamily”: “Windows”,
“OSVersion”: “8”
}
{
“Brand”: “Apple”,
“Model”: “iPhone 4”,
“OSFamily”: “iOS”,
“OSVersion”: “4”
}
{
“Brand”: “Samsung”,
“Model”: “Galaxy S3”,
“OSFamily”: “Android”,
“OSVersion”: “4.0 Ice Cream Sandwich”,
“Display”: “4.8 HD Super AMOLED”
}