Приложения и API-ключи

Обзор

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

Создание приложения

Перейдите в раздел Приложения в боковом меню.
Нажмите Создать приложение.
Введите название (например, backend-api) и необязательное описание.
Подтвердите создание.

Страница приложения

Нажмите на приложение в таблице, чтобы открыть его детальную страницу. Здесь вы увидите:

ID приложения — уникальный идентификатор, используемый как SdkClientId в конфигурации SDK.
Тип — тип приложения (только для чтения).
Описание — редактируемое поле описания.
API-ключи — список ключей этого приложения.

API-ключи

API-ключи аутентифицируют запросы SDK. Каждый ключ принадлежит конкретному приложению.

Генерация ключа

Откройте страницу приложения.
Нажмите Сгенерировать API-ключ.
Скопируйте ключ сразу — он показывается только один раз.

Отзыв ключа

Нажмите кнопку удаления рядом с ключом, чтобы отозвать его. Все экземпляры SDK, использующие этот ключ, перестанут отправлять события. Это действие необратимо.

Использование ключей в SDK

Передайте API-ключ в параметре ApiToken при создании EnmaClient:

await using var enma = new EnmaClient(o =>
{
    o.ApiToken       = "sdk_your_token";
    o.OrganizationId = Guid.Parse("your-org-id");
    o.ProjectId      = Guid.Parse("your-project-id");
    o.SdkClientId    = Guid.Parse("your-app-id");
});