Перейти к основному содержанию
POST
curl
Учётные данные используются каналом устройства, который описан в разделе Отправка событий SDK. Там также перечислено, что сервер проверяет в каждом запросе с устройства и какие события можно безопасно отбрасывать при перегрузке канала.

Авторизации

x-api-key
string
header
обязательно

API-ключ вашего приложения из раздела «Разработчикам» -> «API-ключи» в Business Console. Основной ключ имеет полный доступ. Именованный ключ может иметь ограниченную область действия: без доступа, чтение или запись для каждого ресурса, ограничение определенными сценариями или одобренными сессиями, списком IP-адресов и сроком действия. 401 означает, что ключ неверен, отозван или его срок действия истек; 403 означает, что ключ не был передан, у ключа нет доступа к этому ресурсу или действию, либо запрос поступил с адреса вне его списка IP-адресов; 404 на маршруте сессии означает, что сессия не входит в сценарии или статусы ключа. Ключ без доступа к медиа получает URL изображений, видео и PDF как null, а ключ без прав на запись сессий получает ссылки на сессии и токены как null. См. https://docs.didit.me/console/api-keys.

Тело

application/json

Принимаются псевдонимы в camelCase: vendorData, entityType, allowedEventCategories, ttlSeconds, maxUses, bindToOrigin.

vendor_data
string
обязательно

Ваш id субъекта, к которому относятся все события, переданные с этими учетными данными.

Required string length: 1 - 255
entity_type
string
по умолчанию:individual

company привязывает субъекта-компанию; любое другое значение (по умолчанию individual) привязывает физическое лицо.

Maximum string length: 32
allowed_event_categories
enum<string>[]

Категории, которые могут быть отправлены с этими учетными данными. Опустите этот параметр или отправьте [], чтобы разрешить все категории.

Доступные опции:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
ttl_seconds
integer
по умолчанию:900

Срок действия учетных данных в секундах.

Требуемый диапазон: 60 <= x <= 86400
max_uses
integer | null
по умолчанию:1000

Количество событий, которые могут быть отправлены с помощью этих учётных данных (пакет расходует одно использование на каждое событие). Передайте null, чтобы не ограничивать количество событий в течение срока действия.

Требуемый диапазон: x >= 1
bind_to_origin
string | null

Если параметр задан, заголовок браузера Origin каждого запроса с устройства должен в точности совпадать с этим значением; запрос без Origin отклоняется.

Maximum string length: 255

Ответ

Учетные данные созданы. Передайте monitoring_token приложению и храните его как секрет до момента expires_at.

monitoring_token
string
обязательно

Учётный token устройства (URL-безопасный token из 43 символов). Отправляйте его в заголовке X-Monitoring-Token.

expires_at
string<date-time>
обязательно

Когда учетные данные перестают приниматься.

allowed_event_categories
enum<string>[]
обязательно

Категории, которые могут быть отправлены с этими учетными данными; [] означает все категории.

Доступные опции:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
max_uses
integer | null
обязательно

Бюджет событий для учетных данных; null означает отсутствие ограничения.

bind_to_origin
string | null
обязательно

Источник (origin), к которому привязаны учетные данные, или null.

Последнее изменение 7 ноября 2026 г.