Мост
Мост между сайтом и ядром
Маленькое приложение на сервере владельца: прячет ключ, хранит привязку в cookie и принимает вебхуки. Деньги через него не проходят.
Что делает
/r/<код>— переводит клиента на сайт владельца и запоминает код партнёра вHttpOnlycookie;/v1/claim— привязывает клиента к коду;/v1/order,/v1/refund,/v1/member— передают факты в ядро, с очередью на случай недоступности;/v1/partner-link— ссылка партнёра;- вебхуки ядра принимает он же, с проверкой подписи.
Установка
Скрипт создаёт окружение, выпускает секреты, собирает контейнер и проверяет /health:
./scripts/install.sh
Подробности и проверки — вINSTALL.md.
Переменные
| Переменная | Зачем |
|---|---|
BRIDGE_ENGINE_URL | адрес ядра |
BRIDGE_ENGINE_API_KEY | ключ тенанта |
BRIDGE_DESTINATION_URL | куда вести клиента |
BRIDGE_WEBHOOK_SECRET | подпись вебхуков |
BRIDGE_BRIDGE_TOKEN | токен для серверных вызовов |
Уровни интеграции
Четыре уровня, по возрастанию работы владельца: готовая ссылка, своя регистрация, свой граф, свои экраны. Описание каждого — врепозитории моста.
Контракт фактов — отдельная страница: пять операций, идемпотентность по eventId, коды ошибок.