Практика · API и интеграции
Типичные ошибки при работе с API Kratk
Утечка ключа, устаревший curl, игнор 429, выдуманные endpoint, UTM не на target url.
Интеграция «почти работает»
Команда тратит недели на debug из-за avoidable mistakes.
Antipattern checklist
Сверка с кабинетом и antipatterns ниже.
Пошаговая инструкция
- Перед кодом — свежий curl из UI.
- Checklist PR: no secrets, rate limit handling.
- Integration test: create + redirect one link.
- Document assumed vs verified API fields.
- Review: invent webhook? → remove.
Практический пример
Fix: move Bearer from query string to header — 401 resolved.
Типичные ошибки
- Token in URL query.
- Copy blog snippet from 2024.
- No timeout on HTTP client.
- Assume bulk without docs.
- Client-side API from SPA.
FAQ
Postman collection?
Build from /admin/api-docs curl, share without key.
Versioning /v1?
Use exact path from cabinet example.
Вывод
Меньше сюрпризов = trust cabinet over blog. /docs/api.
Связанные материалы
Нужна короткая ссылка для кампании?
В Kratk можно создать ссылку, поставить её в канал и смотреть переходы в аналитике. Это один из способов — статья полезна и без регистрации.