TenkaTenka
Войти

Центр помощи Tenka › Раздел разработчика › Лучшие практики

Часть этого контента пока на португальском — перевод на ваш язык в работе.

Лучшие практики

Что делает интеграцию долговечной.

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

Неподходящие способы

  • Перебирать весь список каждую минуту — именно это заменяет инкрементальный режим.
  • Делиться API-ключом с конечными пользователями или встраивать его в мобильное приложение или публичную страницу.
  • Писать через API без ответственного пользователя на ключе — след остался бы без автора, отсюда 409.