Программный интерфейс приложения

Application Programming Interface

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

Аналитики проектируют API и определяют:

  • протокол общения (HTTP, HTTPS)
  • формат запроса и ответа (JSON, XML, Protobuf)
  • способы аутентификации и авторизации
Two cat astronauts signing an api agreement

Пример API из реальной жизни

Когда необходимо сориентироваться на местности, мы пользуемся приложением «Карты» (Google Maps, Yandex Maps).

«Карты» предоставляют географическую информацию не только пользователям, но и другим приложениям при помощи API.

Приложение «Навигатор» выступит в роли клиента, а приложение «Карты» — сервера.

  1. «Навигатор» передает запрос по протоколу HTTPS с параметрами начальной и конечной точки маршрута в формате JSON
  2. Получает ответ в формате JSON от приложения «Карты»
  3. Отображает маршрут, ближайшие заправки, предупреждает о загруженности дорог

plain-map
«Карты»
navigator-map
«Навигатор»
Задача

Выступите в роли клиента. Передайте серверу координаты для сохранения стартовой точки.

Заполните форму «Форма для отправки HTTP-запроса» и отправьте HTTP-запрос на сервер.


Форма для отправки HTTP-запроса

Договорённость по формату запроса:

  • URL адрес запрашиваемого ресурса: /startpoint (в данном случае используем только окончание адреса, т.н. эндпоинт)
  • HTTP метод, соответствующий отправке новых данных на сервер (см. HTTP методы)
  • Заголовок с типом контента application/json (указывает на то, что данные будут переданы в JSON формате)
  • Тело запроса должно содержать параметры latitude и longitude в JSON формате
Ключ Описание Тип Обязательность * Ограничения
latitude широта число + от -90.0 до 90.0
longitude долгота число + от -180.0 до 180.0

* Обязательность говорит об обязательности указания поля, может принимать значения:

  • При обязательности +, Y, Yes, Да, 1
  • При необязательности -, N, No, Нет, 0..1

ВВЕДЕНИЕ

БАЗОВЫЕ ЗНАНИЯ

УРОВНИ ТЕСТИРОВАНИЯ

UI ТЕСТИРОВАНИЕ

ТЕСТ ДИЗАЙН

ТЕСТОВАЯ ДОКУМЕНТАЦИЯ

АУТЕНТИФИКАЦИЯ И АВТОРИЗАЦИЯ

POSTMAN

БАЗЫ ДАННЫХ

ТЕСТИРОВАНИЕ РЕЛИЗА

АНАЛИЗ РАБОТЫ ПРИЛОЖЕНИЯ

ПОДГОТОВКА К СОБЕСЕДОВАНИЮ

Как составить резюме Топ вопросов Собеседование