Вебхуки (webhooks) — это POST-запросы, которые Lamoda отправляет на ваш URL при изменении статуса заказа, товара, поставки или при других событиях. Они ускоряют реакцию на изменения, но не заменяют регулярную сверку поллингом (доставка не гарантирована).
Как подключить
Реализуйте на своей стороне endpoint для приёма событий и обратитесь к вашему менеджеру (KAM) или в поддержку. Предоставьте:
- URL для получения нотификаций (HTTPS, до 1024 символов);
- при необходимости — логин и пароль для Basic Auth;
Lamoda настроит подписки на нужные вам события.
Требования к endpoint
Ваш endpoint должен:
- принимать
POST-запросы по HTTPS; - быть доступен 24/7;
- отвечать быстро (рекомендуется \< 5 секунд).
Подписка на события
Подписка связывает имя события и ваш URL: без активной подписки на конкретное событие вебхуки этого типа не приходят. Подписки создаёт и меняет Lamoda.
Аутентификация
Lamoda поддерживает два режима аутентификации при отправке вебхуков:
| Режим | Описание |
|---|---|
none | Без аутентификации (по умолчанию). |
basic | HTTP Basic Auth. Lamoda передаёт заголовок Authorization: Basic <base64(username:password)> при каждом запросе. |
Режим basic включается, если при настройке подписки указаны логин и пароль, иначе — none.
Коды ответов endpoint-ов и повторная отправка
Ваш endpoint подтверждает получение событие одним из следующих HTTP-кодов:
| Код | Поведение Lamoda |
|---|---|
2xx | Доставлено — сообщению присваивается статус sent. |
4xx | Ошибка клиента, статус failed. Повтор не выполняется — проверьте URL, аутентификацию и формат ответа. |
5xx / timeout / connection refused | Повторная отправка с нарастающим интервалом. |
Если попытки исчерпаны, сообщение получает статус failed и сохраняется. Недоставленные нотификации по заказам можно запросить повторно — см. статью «Переотправка нотификаций». Поддерживайте ваш endpoint в стабильно доступном состоянии: чем реже он недоступен, тем меньше событий вы теряете.
См. также
Помогла эта информация?
Спасибо за отзыв