Developer

Синхронные и асинхронные вызовы

↑ 1.1 Что такое API и как устроены системы · ← Предыдущая · → Следующая

Обязательно~7 мин чтенияУровень: junior

Зачем это аналитику и PM

От способа вызова зависят текст на экране и срок в сценарии. Если оплата не отвечает в том же запросе, фраза «кнопка сразу показывает успех» описывает поведение, которого нет.

План темы

  • запрос-ответ
  • очереди и события
  • вебхуки
  • polling
  • как это влияет на сценарий и тайминги

Объяснение

Синхронный вызов — вопрос у стойки: отправитель ждёт ответ и только потом идёт дальше. Асинхронный — заявка: вам выдали номер, итог придёт отдельно.

В мастерской синхронный путь — вы стоите, пока при вас смотрят застёжку. Асинхронный — «оставили, позвоним». Очередь — лоток на столе мастера. Вебхук — мастер звонит сам. Polling, опрос, — вы набираете мастерскую снова и снова.

Запрос и ответ

Клиент держит экран, пока не придут успех или отказ. Так проверяют короткое: хватает ли остатка, верен ли код. В требованиях фиксируют, сколько ждать и что показать при молчании. Молчание — не отказ банка и не успех.

Очереди, события и вебхуки

Очередь хранит сообщение, пока получатель его не заберёт. Событие сообщает факт, который уже случился: «заказ создан». Кто не подписан, тот сам не узнает.

Вебхук — обратный HTTP-вызов. Партнёр сам бьёт в адрес, который мы назвали. Пользователь к этому моменту мог закрыть вкладку, поэтому статус хранят на сервере. Одно уведомление иногда приходит дважды. Нужен признак, что вызов правда от партнёра.

Опрос и тайминги сценария

Опрос выбирают, когда нас некому позвать. Клиент раз в несколько секунд спрашивает статус заявки. Это не требует входящего адреса, но создаёт нагрузку и опаздывает на один интервал. Нужны пауза, момент остановки и текст ожидания.

СпособКто ждётЧто видит человекЧто заложить
Синхронный запросОтправитель до ответаИтог на том же шагеПредел ожидания и текст, если связи нет
Очередь или событиеНикто не стоит над обработчиком«Принято», итог позжеСтатус и поведение при сбое потребителя
ВебхукПартнёр позовёт самИтог после внешнего событияНаш адрес и повтор уведомления
ОпросКлиент спрашивает сноваИтог на очередном запросеИнтервал и предел попыток

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

sequenceDiagram
    participant U as Пользователь
    participant S as Наш сервер
    participant P as Оплата
    U->>S: Оплатить сейчас
    S->>P: Запрос списания
    P-->>S: Успех или отказ
    S-->>U: Экран с итогом

sequenceDiagram
    participant U as Пользователь
    participant S as Наш сервер
    participant P as Оплата
    U->>S: Оплатить сейчас
    S-->>U: Принято в работу
    S->>P: Запрос списания
    P-->>S: Позже присылает итог
    U->>S: Узнать статус
    S-->>U: Оплачен или отказ

Первая схема обещает итог в том же ожидании. Вторая честно пишет «принято», а «оплачено» появляется отдельным шагом.

Примеры

Публичный httpbin умеет задержать ответ. Это иллюстрация синхронной паузы, не ваш банк. Состав тела смотрите у сервиса.

curl -sS "https://httpbin.org/delay/1"

Схема асинхронной оплаты для постановки, не ответ платёжной системы.

{
  "orderId": "1042",
  "paymentStatus": "accepted"
}

Пока статус accepted, экран не пишет «оплачено». Итог приходит вебхуком или опросом. Имена статусов ниже учебные, в вашем контракте будут другие.

GET /orders/1042
повторять, пока статус не станет итогом
интервал задаёт команда, не эта заметка

Нюансы и подводные камни

  • «Заявка принята» и «деньги списаны» — разные факты. Им нужны разные слова на экране.
  • Повтор кнопки после таймаута может создать второй платёж. Напишите, что делать со вторым таким же запросом.
  • Вебхук приходит и раньше экрана, и после закрытия вкладки. Память страницы — плохой источник статуса.
  • Повторная доставка уведомления не должна второй раз отгружать тот же заказ.

Практика

Разложите «оплатить заказ» на синхронный и асинхронный столбцы: что видно в первые секунды, откуда берётся итог, что показано, если партнёр молчит.

Ожидаемый результат: в синхронном столбце итог приходит в том же ожидании. В асинхронном сначала написано «принято», а «оплачено» — только после вебхука или опроса. Молчание в обоих столбцах не названо отказом банка.

Вопросы с ответами

Связано с блоком Developer

Связанные темы

Вид графа

Обратные ссылки