Результат: ваша система примет событие платформы, проверит его и не создаст дубль при повторной доставке.
События
application.created— новая заявка.application.updated— изменились данные.application.status_changed— изменился статус.
Настройка платформы
- Подготовьте публичный HTTPS-адрес, принимающий POST-запросы.
- Откройте вкладку Webhook и выберите «Своя система: JSON».
- Укажите адрес без токена в query string.
- Выберите события.
- Создайте отдельный секретный ключ.
- Проверьте предпросмотр данных запроса и выполните тест.
Минимальная обработка
POST /hooks/appsmax HTTP/1.1
Content-Type: application/json
X-Appsmax-Event: application.created
{
"event": "application.created",
"application": { "id": 123 }
}Фактические поля и алгоритм проверки берите из контракт исходящих webhook. Не угадывайте подпись по старому примеру.
Ответы и повторы
| Результат | Что вернуть | Что произойдёт |
|---|---|---|
| Данные приняты | 2xx |
Доставка считается успешной |
| Временная перегрузка | 408, 429 или 5xx |
Платформа может повторить доставку |
| Постоянная ошибка запроса | другой 4xx |
Автоматический повтор не обещается |
Публичный контракт фиксирует до пяти попыток и интервалы 60, 300 и 900 секунд. Семантика — at least once. Используйте событие, application.id и текущее состояние для идемпотентности.
Ошибки
415— обработчик не принимает JSON.413— ограничение размера тела слишком низкое.401/403— проверка секретного ключа или подписи не прошла.5xx— не возвращайте успех до фактического принятия данных.
Отключение
Выключите подключение в кабинете, дождитесь завершения уже начатых обработок, удалите тестовые данные и замените секретный ключ, если адрес или журнал были раскрыты.
Если не хочется разбираться самостоятельно, мы можем помочь. Поможем настроить платформу под вашу задачу и быстрее запустить проект без лишних шагов.