Лучшие практики
Что делает интеграцию долговечной.
- Используйте инкрементальный режим (desde + depoisDe) для синхронизации: приходит только изменённое, лимит не исчерпывается.
- Обрабатывайте 429, ожидая Retry-After с экспоненциальной задержкой — никогда не повторяйте в тесном цикле.
- Передавайте Idempotency-Key в каждом POST: сеть упала, рутина повторилась — ничего не дублируется.
- Проверяйте подпись вебхука перед обработкой; быстро отвечайте 2xx и обрабатывайте потом.
- Один ключ на интегрируемую систему с минимально достаточным scope; отзывайте неиспользуемые.
Неподходящие способы
- Перебирать весь список каждую минуту — именно это заменяет инкрементальный режим.
- Делиться API-ключом с конечными пользователями или встраивать его в мобильное приложение или публичную страницу.
- Писать через API без ответственного пользователя на ключе — след остался бы без автора, отсюда 409.