События
| Событие | Когда отправляется |
|---|---|
| client.created | Добавлен клиент. |
| order.submitted | Подана заявка. |
| order.approved | Заявка одобрена. |
| order.settled | Расчёт по заявке завершён, доли выпущены. |
| distribution.approved | Выплата одобрена. |
| transfer.completed | Передача между инвесторами завершена. |
| message.received | Клиент отправил сообщение. |
Полезная нагрузка содержит идентификаторы, числа и суммы, но никаких персональных данных. Ваша система получает подробности с помощью ключа API.
Добавление адреса
- Откройте Настройки, затем Вебхуки, и выберите Добавить адрес.
- Введите адрес
https, который отвечает статусом 2xx в течение нескольких секунд. Выберите события. - Скопируйте секрет подписи. Он показывается один раз.
- Выберите Отправить тестовое событие, чтобы проверить доставку.
- Принимаются только адреса
httpsна публичных хостах. Адреса, ведущие в частные или внутренние сети, отклоняются. - Перенаправления не выполняются.
Проверка подписи
Каждая доставка — это JSON-запрос POST с заголовками EasyHaus-Event, EasyHaus-Delivery и EasyHaus-Signature. Подпись имеет вид t=<unix time>,v1=<hex>. Вычислите HMAC-SHA256 текста <t>.<raw body> с вашим секретом, сравните результат с v1 и отклоняйте устаревшие отметки времени.
Тело запроса: {id, type, created_at, organization_id, data}.
Повторные попытки и отключение
- Отвечайте в течение 10 секунд. Неудачная доставка повторяется с растущими интервалами, до 10 попыток.
- После 20 неудач подряд адрес отключается, а владельцам и администраторам приходит письмо. Устраните проблему и включите адрес снова — счётчик сбросится.
- Журнал доставки показывает каждую доставку, её статус и HTTP-код и позволяет доставить повторно.
- Вы можете изменить события, отключить адрес, сменить секрет (старый сразу перестаёт действовать) или удалить адрес.