Пример из практики: одно устройство передает данные о посещаемости на несколько серверов
Требование
Клиенту требовалось одно биометрическое устройство, но данные о посещаемости нужно было передавать в две отдельные программные системы. Например, во внутреннюю HR-платформу и во внешнего поставщика системы расчета зарплаты, без установки второго устройства и без разделения оборудования между ними.
Почему подходит концепция двойного API
Обычно одно устройство связано с одним API и одним URL обратного вызова: каждая отметка передается в один пункт назначения. Концепция двойного API снимает это ограничение «один к одному». Вместо добавления оборудования клиент приобретает дополнительную лицензию API для того же физического устройства. Каждый API получает собственный URL обратного вызова, и устройство передает каждую запись о посещаемости на все настроенные URL одновременно, а не последовательно и не с задержкой.
Это означает, что клиенту не нужны два устройства на входе, два процесса регистрации или два комплекта технического обслуживания оборудования. Одна отметка, одно устройство, несколько получателей.
Как работает процесс
Процесс двойного API: одна отметка одновременно передается на два настроенных URL обратного вызова
- Пользователь отмечается на устройстве как обычно, для конечного пользователя ничего не меняется.
- На устройстве настроены два (или более) API, каждый из которых указывает на собственный URL обратного вызова.
- Запись о посещаемости одновременно передается на каждый настроенный URL.
- Каждый принимающий сервер или программа обрабатывает запись независимо: ответ одного не влияет на другой.
Масштабирование за пределы двух
Количество получателей не ограничено двумя. Та же концепция распространяется на n API на одном устройстве, где каждый дополнительный API — это еще один теневой API с собственным URL обратного вызова, и устройство передает данные на все них одновременно. Например, клиент, который синхронизирует данные о посещаемости с HR, системой расчета зарплаты и панелью контроля соответствия требованиям, может настроить три API на одном устройстве вместо работы с тремя отдельными считывателями.
Что входит в покупку
|
Первый API на устройстве
|
Каждый дополнительный (теневой) API
Стоимость устройства не начисляется, так как используется уже имеющееся устройство. |
Рекомендации по внедрению
- Каждая пара «API и URL обратного вызова» работает независимо: сбой или медленный ответ по одному URL обратного вызова не блокирует и не задерживает доставку на остальные.
- Поскольку доставка выполняется одновременно, а не путем передачи данных от одного сервера к другому, между принимающими системами не возникает цепочки зависимостей.
- Этот вариант хорошо подходит, когда две системы нужны одни и те же исходные данные о посещаемости для разных целей (например, расчет зарплаты и журналирование доступа), а не для взаимодействия друг с другом.
- Каждый API и его URL обратного вызова настраиваются независимо на панели управления, поэтому добавление теневого API не требует перенастройки самого устройства.
- Используйте API Monitor, чтобы проверять доставку на каждый теневой API отдельно, так как проблема с доставкой на один URL обратного вызова не обязательно отобразится на другом.
- Поскольку получатели полностью независимы, двойной API также удобен для параллельной миграции: существующая система продолжает получать данные, пока новая система проходит проверку, а затем старый URL обратного вызова отключается, когда вы уверены в переходе.
Результат
Клиент выполнил требование о двух получателях, используя имеющееся единственное устройство, и избежал затрат и сложности, связанных со вторым устройством. Для настройки была приобретена только дополнительная лицензия API для второго получателя, а стоимость устройства была учтена один раз.