раздел 01

API: запрос-ответ

API - самый частый вид интеграции. Логика простая: ваша программа делает запрос к чужому сервису и сразу получает ответ. Спросили - ответили.

Бытовая аналогия - официант. Вы говорите: «Капучино, пожалуйста». Через минуту получаете капучино. Вы инициатор: пока вы не попросили, ничего не происходит. Кухня сама вам кофе не принесёт.

Как это выглядит

1
Вы формулируете запрос
Например: «дай курс доллара» или «создай заказ с такими товарами».
2
Отправляете его сервису
Программа обращается по адресу API - это как номер телефона нужного отдела.
3
Сервис обрабатывает и отвечает
Возвращает данные («курс - 90 рублей») или подтверждение («заказ создан, номер 1024»).

Два ключевых свойства этого вида:

  • Синхронно. Вы отправили запрос и ждёте ответ здесь и сейчас, как разговор по телефону.
  • Инициатор - вы. Связь начинается с вашей стороны. Сервис молчит, пока его не спросят.

Когда применяют

Когда вам нужно что-то получить или сделать прямо сейчас по своей инициативе: узнать остаток на складе, проверить статус заказа, отправить сообщение, создать запись. Большинство интеграций между сервисами устроены именно на API.

Простой пример

Сайт магазина хочет показать актуальный курс валют. Он делает запрос к API банка: «курс доллара?». Банк отвечает: «90.50». Сайт показывает цифру посетителю. Каждый раз, когда нужен свежий курс, сайт спрашивает заново.