Настройки API-нотификаций

Для получения нотификаций у партнера должна быть реализована точка входа на принятие запроса, которая будет всегда доступна. При необходимости Lamoda B2B Platform может авторизовываться по механизму Basic Auth.

Чтобы избежать блокировки входящих POST запросов, необходимо получить у KAM IP адрес Lamoda B2B Platform и занести его в Whitelist сервиса, взаимодействующего с Lamoda B2B Platform.

Требования к обработке нотификаций

На стороне Lamoda B2B Platform процесс отправки нотификаций контролируется по коду ответа сервиса партнера в соответствии со следующими правилами:

• 2хх - нотификации успешно доставлены;
• 3хх - редирект нотификации по новому адресу. Максимальное количество редиректов - 5 (после этого будет ошибка запроса);
• 4хх - ошибка получения нотификаций, процесс отправки прекращается;
• 5хх - ошибка получения нотификаций, повторная отправка нотификации будет осуществлена спустя 80 секунд, если вновь получен код ответа 5хх - последующие нотификации будут отправляться с интервалами, увеличивающимися в геометрической прогрессии - ((80 секунд) х 3 х N, где N - номер попытки). Максимальное количество попыток переотправки - 5;
• если сервис не отвечает, будет выполняться повторная переотправка нотификации по тому же алгоритму, что и при получении в ответе кода ошибки 5хх.
  

Пример работы алгоритма переотправки нотификаций:

• Попытка 1, время отправки 10: 00:00, следующая отправка через 80 сек;
• Попытка 2, время отправки 10: 01:20, повторная отправка через 240 сек;
• Попытка 3, время отправки 10: 05:20, повторная отправка через 720 сек;
• Попытка 4, время отправки 10: 17:20, повторная отправка через 2160 сек;
• Попытка 5, время отправки 10: 53:20.
  

Тело ответа

Lamoda B2B Platform не предъявляет требований к телу ответа, но рекомендуем в ответе возвращать любой текст с информацией об успешном получении сообщения. Это поможет при тестировании и сопровождении функциональности в будущем.

Обратная совместимость

Для обеспечения обратной совместимости не следует реализовывать валидацию по количеству полей, поскольку это может повлечь за собой ошибки обработки данных в случае изменения набора полей нотификаций на стороне Lamoda B2B Platform. Со стороны Lamoda B2B Platform обеспечивается полная обратная совместимость по следующим правилам:

• Существующие поля не удаляются;
• Тип существующих полей не изменяется.