Saltar al contenido principal
POST
curl
La credencial la utiliza el canal del dispositivo, descrito en Envío de eventos desde el SDK, donde también se indica qué exige el servidor en cada solicitud del dispositivo y qué eventos se pueden descartar sin riesgo cuando hay contrapresión.

Autorizaciones

x-api-key
string
header
requerido

La clave de API de tu aplicación, que encontrarás en Developers -> API keys en la Business Console. La clave principal tiene acceso completo. Una clave con nombre puede tener un alcance limitado: ninguno, lectura o escritura por recurso, limitada a algunos flujos o a sesiones aprobadas, a una lista de direcciones IP y a una fecha de caducidad. 401 significa que la clave es incorrecta, se revocó o expiró; 403 significa que no se envió ninguna clave, que la clave no tiene acceso a este recurso o acción, o que la solicitud provino de una dirección fuera de su lista de IP; 404 en una ruta de sesión significa que la sesión está fuera de los flujos o estados de la clave. Una clave sin acceso a contenido multimedia recibe las URL de imágenes, videos y PDF como null, y una clave sin permiso de escritura en sesiones recibe los enlaces y tokens de sesión como null. Consulta https://docs.didit.me/console/api-keys.

Cuerpo

application/json

Se aceptan alias en camelCase: vendorData, entityType, allowedEventCategories, ttlSeconds, maxUses, bindToOrigin.

vendor_data
string
requerido

Tu ID para el sujeto al que pertenecen todos los eventos enviados con esta credencial.

Required string length: 1 - 255
entity_type
string
predeterminado:individual

company vincula un sujeto de tipo empresa; cualquier otro valor (por defecto, individual) vincula una persona física.

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

Categorías que la credencial puede enviar. Omítelo o envía [] para permitir todas las categorías.

Opciones disponibles:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
ttl_seconds
integer
predeterminado:900

Vida útil de la credencial en segundos.

Rango requerido: 60 <= x <= 86400
max_uses
integer | null
predeterminado:1000

Número de eventos que la credencial puede enviar (un lote consume un uso por evento). Envía null para no establecer límite dentro de su vigencia.

Rango requerido: x >= 1
bind_to_origin
string | null

Si se define, el encabezado Origin del navegador de cada solicitud del dispositivo debe ser exactamente igual a este valor; se rechaza toda solicitud sin Origin.

Maximum string length: 255

Respuesta

Se emitió la credencial. Entrega monitoring_token a la app y trátalo como un secreto hasta expires_at.

monitoring_token
string
requerido

La credencial del dispositivo (un token de 43 caracteres seguro para URL). Envíala en el encabezado X-Monitoring-Token.

expires_at
string<date-time>
requerido

Cuándo deja de aceptarse la credencial.

allowed_event_categories
enum<string>[]
requerido

Categorías que la credencial puede enviar; [] significa todas las categorías.

Opciones disponibles:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
max_uses
integer | null
requerido

Presupuesto de eventos de la credencial; null significa que no hay límite.

bind_to_origin
string | null
requerido

Origen al que está vinculada la credencial, o null.

Última modificación el 1 de noviembre de 2026