Utilisateurs API

Visiteur

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

Cet endpoint vous permet de récupérer les propriétés d'un visiteur spécifique. Lorsque vous créez le token, vous pouvez définir quelles propriétés renvoyer.

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	(facultatif) Callback pour la requête JSONP
token	string	Jeton de sécurité
site	entier	ID du site
tcid	string	ID du cookie. S'il est vide (recommandé), il lira le tcid dans le cookie de l'utilisateur.

200

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

Utilisation First-party

Si votre site utilise un domaine first-party (soit via un sous-domaine dédié, soit via le chemin Commanders Act Gateway), les appels API doivent être effectués sur votre propre domaine.

Important : l'URL doit inclure /api/ dans le chemin. Sans ce chemin, la requête ne fonctionnera pas.

1. Utilisation d'un sous-domaine dédié (exemple : tracking.mydomain.com)

La structure de l'API first-party doit suivre ce modèle : https://tracking.mydomain.com/api/1.0/engage/visitors/

Exemple : https://tracking.mydomain.com/api/v1.0/engage/visitors/?site=5326&tcid=&token=XXXX

2. Utilisation de Commanders Act Gateway (configuration basée sur un chemin)

Si votre endpoint gateway est servi sous un chemin (par exemple : https://www.mydomain.com/cact-proxy/), la structure de l'API first-party doit suivre ce modèle : https://www.mydomain.com/cact-proxy/api/1.0/engage/visitors/

Exemple : https://www.mydomain.com/cact-proxy/api/v1.0/engage/visitors/?site=5326&tcid=&token=XXXX

Remarque : conservez toujours la /api//… après le sous-domaine ou le chemin gateway.

Utilisateur

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

Cet endpoint vous permet de récupérer les propriétés d'un utilisateur spécifique sur la base d'un user_id. Lorsque vous créez le token, vous pouvez définir quelles propriétés renvoyer.

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 Consent 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.

N'utilisez pas cet endpoint client-side

L'endpoint GET User doit affinons pas être appelé depuis le navigateur. Exposer le token permettrait à n'importe qui de le capturer et de parcourir les ID utilisateurs pour extraire toutes les données utilisateur.

Utilisez cette API server-side uniquement dans un environnement backend sécurisé.

Utilisateur

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

//Exemple de format
{
    "person": {
        "id": "10000000",
        "card": "12345678910",
        "email": "[e-mail]",
        "gender": "female",
        "firstname": "Joan",
        "lastname": "Craig",
        "custom": {
            "area_number": 123
        },
    ...
    }
}

DELETE utilisateur

Supprimer un utilisateur

URL de la ressource

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

Informations sur la ressource

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

Paramètres

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

Exemple de requête

DELETE

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

Réponse

{"success":true}