Практика · API и интеграции
Как получать аналитику по ссылкам через API
Экспорт кликов через API — проверьте docs; если endpoint partial, используйте UI + свой polling.
Нужен отчёт в BI без ручного экспорта
Data team хочет клики в warehouse; неясно, есть ли analytics API.
API или polling UI-данных
Сначала /docs/api и /admin/api-docs на read stats. Если analytics API [GAP] или partial — периодический export доступных методов + клики из UI вручную на MVP; не выдумывайте GET /analytics/all.
Пошаговая инструкция
- Найдите в кабинете методы read/update link и stats (если есть).
- Прототип: один slug → один запрос stats.
- Cron nightly: список slug → aggregate.
- Load в BI (BigQuery, Postgres).
- Fallback: webhook-style polling (см. отдельную практику).
Практический пример
Ежедневный job тянет clicks_7d для активных campaign slug в internal dashboard.
Типичные ошибки
- Assumption полного parity analytics API.
- Pull каждую минуту без need — 429.
- Смешивание timezone в отчётах.
- Нет связи slug ↔ utm_campaign в DWH.
FAQ
Real-time?
Зависит от доступных endpoint; часто достаточно hourly/daily batch.
Webhooks на клик?
Если нет в docs — polling alternative, не invent webhook.
Вывод
Analytics via API — только documented methods. Сверка — /docs/analytics и кабинет.
Связанные материалы
Нужна короткая ссылка для кампании?
В Kratk можно создать ссылку, поставить её в канал и смотреть переходы в аналитике. Это один из способов — статья полезна и без регистрации.