Руководства
Как начать работу с API Kratk
Ключ → пример curl из кабинета → первый POST создания ссылки → проверка в UI.
С чего начать интеграцию
Разработчик ищет «документацию API» в блоге, копирует устаревший curl, ключ попадает в git. Нужен короткий безопасный старт.
Пять шагов через кабинет
Официальный маршрут: обзор API → ключ → страница API с живым примером → тестовый запрос → ссылка видна в кабинете.
Пошаговая инструкция
- Прочитайте обзор API.
- Создайте ключ: API-ключи.
- Откройте /admin/api-docs, скопируйте curl для create link.
- Выполните запрос из терминала или Postman; сохраните ответ (short URL).
- Проверьте ссылку в кабинете и тестовый переход.
Практический пример
curl -X POST … -H 'Authorization: Bearer sk_…' -d '{"url":"https://example.com/promo"}' → получаете kratk.ru/s/abc и видите запись в списке ссылок.
Типичные ошибки
- Ключ в .env без .gitignore.
- Копирование примера из сторонней статьи, не из кабинета.
- Тест на prod-ключе без отдельного dev-ключа (если политика команды требует).
- Ожидание всех полей short.io без сверки ответа API.
FAQ
Есть ли sandbox?
Используйте отдельный ключ и тестовые slug; отдельный sandbox — уточните в справке продукта.
Где OpenAPI/Swagger?
Актуальные примеры — в кабинете на /admin/api-docs.
Вывод
Старт API = ключ + curl из кабинета + проверка в UI. Дальше — практики массового создания и безопасности.
Нужна короткая ссылка?
В Kratk можно создать ссылку и смотреть переходы в аналитике. Статья полезна и без регистрации.