Utilisateurs API

Visiteur

GET https://api.commander1.com/v1.0/engage/visitors/

Ce endpoint vous permet de

obtenir des propriétés pour un visiteur spécifique

. Lorsque vous créez le token, vous pouvez définir quelles propriétés retourner.

\

Cette API est davantage conçue pour être appelée depuis un tag dans le navigateur de chaque utilisateur.

Paramètres de requête

Nom	Type	Description
callback	string	(optionnel) Callback pour requête jsonp
token	string	Jeton de sécurité
site	entier	ID du site
tcid	string	Identifiant cookie. Si vide (recommandé) il lira le tcid dans le cookie de l'utilisateur.

200

{
    "user_age": 39,
    "user_privacy_categories": [
      "11",
      "12",
      "13"
    ]
}

User

GET https://api.commander1.com/engage/user/

Ce endpoint vous permet de

obtenir des propriétés pour un utilisateur spécifique

basé sur un

user_id

. Lorsque vous créez le token, vous pouvez définir quelles propriétés retourner.

Paramètres de requête

Nom	Type	Description
token	string	Jeton de sécurité
user_id	string	ID de l'utilisateur
site	entier	ID du site

200 Consentement récupéré avec succès.

{
    "user_age": 39,
    "user_privacy_categories": [
      "11",
      "12",
      "13"
    ]
}

404 Impossible de trouver un utilisateur correspondant à cette requête.

User

PUT https://api.commander1.com/engage/user/

Insérer ou mettre à jour un utilisateur

Paramètres de requête

Nom	Type	Description
site	string	Id du site (compte)
user_id	string	ID de l'utilisateur.
token	string	Jeton de sécurité

200

{"success":true}

Exemple de requête

PUT

https://api.commander1.com/engage/user/?site=1234&user_id=1234&token=WvNIX8955cnZ7WF0f632s0Wb99Ql3rtA

{
"preferences.channel":"email",
"preference.frequency":"30d",
...
}

SUPPRIMER utilisateur

Supprimer un utilisateur

URL de la ressource

https://api.commander1.com/engage/user/

Informations sur la ressource

Formats de réponse	JSON
Requiert une authentification ?	Oui (token)

Paramètres

NOM	EXIGENCE	VALEURS D'EXEMPLE	DESCRIPTION
site	d+	1234	ID du site
user_id	d+	1234	ID de l'utilisateur
tc_id (optionnel)	d+	1234	ID du visiteur
token	[a-zA-Z0-9]*	WvNIX8955cnZ7WF0f632s0Wb99Ql3rtA	Jeton de sécurité

Exemple de requête

SUPPRIMER

https://api.commander1.com/engage/user/?site=1234&user_id=1234&tc_id=1234&token=WvNIX8955cnZ7WF0f632s0Wb99Ql3rtA

Réponse

{"success":true}