Как тестировать API

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

Для удобства созданы единые стандарты API. Например, REST — стандарт взаимодействия, который полностью построен на протоколе HTTP, при котором идентификация пользователя и все параметры выполнения операции передаются в каждом запросе.

Тестирование API является интеграционным, т.е. подразумевается проверка взаимодействия частей системы программы. Удобным инструментом для проверки выходных данных является Postman.

Основные возможности Postman:

• Создавать и отправлять запросы;
• Сохранять запросы в каталоги и коллекции;
• Параметризовать запросы;
• Добавлять к вызову API контрольные точки;
• Создавать разные окружения для одних и тех же запросов;
• Запускать коллекции с помощью Collection Runner и использовать их как автоматизированные тесты.

Итак, как же работать с Postman:

1. Для начала необходимо загрузить и установить последнюю версию Postman с официального сайта https://www.postman.com/downloads/
2. Далее в интерфейсе в меню выбрать «File» — «New Tab»

откроется вкладка запросом и параметрами:

3. На примере API Яндекс.Погода запросим информацию с помощью метода GET. Для этого необходимо зарегистрироваться в кабинете разработчика и получить API ключ.

4. Далее переходим в описание API Яндекс.Погода (документация):

5. В Postman на вкладке Authorization вводим наш API ключ:

6. Далее в строке запроса выбираем запрос GET и вводим адрес запроса https://api.weather.yandex.ru/v1/forecast? и нажимаем на кнопку «Send». Внизу формы появится результат запроса в формате JSON:

Возможно добавлять параметры такие как:

   lat=<широта>
 & lon=<долгота>
 & [lang=<язык ответа>]
 & [limit=<срок прогноза>]
 & [hours=<наличие почасового прогноза>]
 & [extra=<подробный прогноз осадков>]

Введем, например, широту и долготу и отправим наш запрос:

В итоге в ответе придет информация о погоде в г. Стамбул: