Создать первый проект в Konso и подключить API
Пошаговая инструкция: зарегистрируйтесь, создайте проект, получите API-ключ и отправьте первый запрос за 5 минут.
Открыть Konso arrow_forwardTL;DR
- check_circleЗарегистрируйтесь на app.konso.io и войдите в аккаунт
- check_circleСоздайте проект — каждый проект изолирован и имеет свои ключи доступа
- check_circleСкопируйте Access Key и Bucket ID в разделе Настройки → API Access
- check_circleИспользуйте эти данные для отправки логов, метрик или событий через API
Что вы сделаете в этом уроке
В конце вы будете иметь рабочий проект в Konso с API-ключом, готовым к интеграции. Весь процесс занимает около 5 минут.
Шаг 1. Регистрация и вход
Откройте app.konso.io
Перейдите на https://app.konso.io. Если у вас ещё нет аккаунта — нажмите «Зарегистрироваться» и создайте его.
Войдите в аккаунт
Введите email и пароль, нажмите «Войти». Вы попадёте на главный экран платформы.
Шаг 2. Создание проекта
Перейдите в список проектов
В главном меню нажмите на переключатель проекта в верхней части боковой панели. Откроется список ваших проектов.
Создайте новый проект
Нажмите кнопку «Создать проект» (или «+ New Project»). Введите название проекта и, при необходимости, описание.
Выберите часовой пояс
В настройках проекта укажите часовой пояс — это влияет на отображение временны́х меток в логах и метриках.
Сохраните настройки
Нажмите «Сохранить». Проект создан — теперь он доступен в переключателе проектов.
Шаг 3. Получение API-ключа
Откройте настройки проекта
Убедитесь, что выбран нужный проект. Перейдите в раздел «Настройки» → «API Access» (Settings → API Access) в боковом меню.
Скопируйте Access Key
Нажмите на иконку копирования рядом с полем Access Key. Этот ключ используется в заголовке запроса x-api-key.
Скопируйте Bucket ID
Скопируйте Bucket ID — идентификатор вашего проекта. Он используется в URL запросов к API.
Запишите API URL
Скопируйте базовый URL API. Он нужен для формирования конечных точек при отправке данных.
Важно
Access Key — секретный ключ. Не передавайте его в открытом виде и не публикуйте в репозитории. Если ключ скомпрометирован, используйте кнопку обновления (иконка обновления рядом с полем) для генерации нового.
Шаг 4. Включение нужных модулей
Перейдите в General Settings
В разделе «Настройки» → «Общие» (Settings → General) найдите блок «Функциональность».
Включите нужные модули
В разделе «Опциональные функции» включите переключатели для модулей, которые планируете использовать: Logs, Metrics, Value Tracking, Dispatch, CMS.
Сохраните изменения
Нажмите кнопку «Сохранить» рядом с блоком функциональности. Изменения вступают в силу немедленно.
Шаг 5. Первый запрос к API
Отправьте тестовый лог
Используйте скопированные Access Key и Bucket ID для отправки первого события. Пример запроса для отправки лога:
Результат
Если запрос вернул succeeded: true — всё настроено правильно. Событие появится в разделе Logs вашего проекта в Konso.
Что делать дальше
- check_circleПодключите Konso SDK для .NET для более удобной интеграции
- check_circleНастройте алерты на критические ошибки в разделе Alerts
- check_circleДобавьте трекинг бизнес-событий через Value Tracking API
- check_circleНастройте Dispatch для доставки уведомлений в Telegram или Email
- check_circleИзучите CMS для управления контентом с AI-агентами
Готово — ваш первый проект настроен
Начните отправлять данные прямо сейчас или изучите возможности платформы подробнее
Открыть Konso arrow_forward