Passer au contenu principal
POST
curl
L’identifiant d’authentification est utilisé par le canal des appareils, décrit dans Envoi des événements SDK, qui énumère également les règles que le serveur impose à chaque requête émise depuis un appareil, ainsi que les événements qui peuvent être abandonnés sans risque en cas de saturation.

Autorisations

x-api-key
string
header
requis

La clé API de votre application, issue de Développeurs -> Clés API dans la Business Console. La clé principale dispose d'un accès complet. Une clé nommée peut être restreinte : aucun, lecture ou écriture par ressource, limitée à certains workflows ou aux sessions approuvées, à une liste d'adresses IP et à une date d'expiration. 401 signifie que la clé est incorrecte, révoquée ou expirée ; 403 signifie qu'aucune clé n'a été envoyée, que la clé n'a pas accès à cette ressource ou action, ou que la requête provient d'une adresse hors de sa liste d'IP ; 404 sur une route de session signifie que la session est hors des workflows ou des statuts de la clé. Une clé sans accès aux médias reçoit les URL d'images, de vidéos et de PDF à null, et une clé sans accès en écriture aux sessions reçoit les liens et tokens de session à null. Voir https://docs.didit.me/console/api-keys.

Corps

application/json

Les alias en camelCase sont acceptés : vendorData, entityType, allowedEventCategories, ttlSeconds, maxUses, bindToOrigin.

vendor_data
string
requis

Votre identifiant pour le sujet auquel appartient chaque événement soumis avec cet identifiant d'accès.

Required string length: 1 - 255
entity_type
string
défaut:individual

company associe un sujet de type entreprise ; toute autre valeur (individual par défaut) associe un individu.

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

Catégories que l'identifiant peut soumettre. Omettez-le ou envoyez [] pour autoriser toutes les catégories.

Options disponibles:
auth,
session,
gameplay,
bonus,
affiliate,
payment,
dispute,
security,
responsible_gambling,
custom
ttl_seconds
integer
défaut:900

Durée de vie des informations d'identification en secondes.

Plage requise: 60 <= x <= 86400
max_uses
integer | null
défaut:1000

Nombre d'événements que l'identifiant peut soumettre (un lot consomme une utilisation par événement). Envoyez null pour ne pas appliquer de plafond pendant la durée de validité.

Plage requise: x >= 1
bind_to_origin
string | null

Lorsqu'il est défini, l'en-tête Origin du navigateur de chaque requête de l'appareil doit correspondre exactement à cette valeur ; une requête sans Origin est refusée.

Maximum string length: 255

Réponse

L'identifiant d'authentification a été créé. Transmettez monitoring_token à l'application et traitez-le comme un secret jusqu'à expires_at.

monitoring_token
string
requis

L'identifiant d'authentification de l'appareil (un token de 43 caractères compatible avec les URL). Envoyez-le dans l'en-tête X-Monitoring-Token.

expires_at
string<date-time>
requis

Date et heure à partir desquelles le justificatif cesse d'être accepté.

allowed_event_categories
enum<string>[]
requis

Catégories que l'identifiant peut soumettre ; [] signifie toutes les catégories.

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

Budget d'événements de l'identifiant ; null signifie sans plafond.

bind_to_origin
string | null
requis

Origine à laquelle l'élément d'authentification est lié, ou null.

Dernière modification le 7 novembre 2026