API
Автоотключение вебхуков: события лучше доходят до рабочих URL
Если URL вебхука перестаёт отвечать, 1MSG ставит отправку на него на паузу. Проверьте, что ваши URL работают.
1MSG теперь ограничивает отправку на URL, которые не отвечают. Так события доходят до URL, которые работают. Рабочие URL и остальной продукт не меняются: события приходят как раньше.
События быстрее доходят до рабочих URL
Раньше 1MSG пытался отправить каждое событие на каждый URL вебхука, который вы указали, — даже если этот URL давно не работал. Например, забыли убрать тестовый URL, не продлили хостинг, сменили домен или поменяли URL интеграции и не обновили его у нас. Каждая такая попытка занимает очередь и тормозит URL, которые ещё работают.
Теперь мы не шлём на URL, которые не отвечают, чтобы события доходили до тех, которые отвечают.
Как это работает
К рабочим URL это не относится. Если URL работает, события приходят как раньше. Сбой — это timeout, ошибка сети или HTTP 5xx, 401, 403, 404, 410 и 429, не любой код ответа.
Если URL перестаёт отвечать, мы не отключаем его сразу. Отправка продолжается. После второго сбоя шлём предупреждение на email, события всё ещё уходят. Если через 10 минут URL так и не отвечает, ставим отправку на него на паузу.
Дальше 1MSG проверяет, не вернулся ли URL: через 15 минут, потом через час, потом через шесть часов. Ответ 2xx сам включает отправку снова. Если все три проверки не прошли, отправка на этот URL остаётся на паузе, и мы пишем вам, что она остановлена.
Шесть часов — последняя проверка. URL остаётся отключённым. Без 2xx вернуть отправку можно только если снова указать URL вебхука.
Как вернуть отправку
Если пришло письмо или события перестали приходить на один из URL, используйте GET /webhook или GET /settings. В статусе по каждому URL видно, какой на паузе — так вы знаете, что включать обратно.
Отправка включается сама, если за первые шесть часов проверка получит 200. Если URL так и не ответил, включите сами: снова вызовите POST /webhook и передайте полный список URL, которые должны остаться. Этот запрос заменяет весь список. Если отправить один URL из трёх, два других пропадут.
Письма с предупреждением и об отключении уходят владельцу канала. Если не хотите их получать, можно отписаться.
Документация метода, если понадобится позже: GET /webhook