GET/PUT Consents / preferences

Obtenir/mettre à jour le consentement utilisateur stocké dans DataCommander

Consentements utilisateur

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

Cet endpoint vous permet d'obtenir le consentement de la catégorie pour un utilisateur spécifique

Paramètres de requête

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

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

{
    "user_privacy_optin": 1,
    "user_privacy_categories": [
      "11",
      "12",
      "13"
    ]
}

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

Consentements visiteur

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

Cet endpoint vous permet d'obtenir le consentement de la catégorie pour un visiteur spécifique

Paramètres de requête

Nom	Type	Description
callback	string	(facultatif) Callback pour une requête jsonp
token	string	Jeton de sécurité
site	integer	ID du site
tc_id	String	Facultatif. ID cookie de l'utilisateur

200 Exemple avec réponse optin

{
    "user_privacy_optin": 1,
    "user_privacy_categories": [
      "11",
      "12",
      "13"
    ]
}

202 Exemple avec réponse optout

404

User

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

Insérer ou mettre à jour une préférence dans la base de données (nécessite d'avoir le module DataCommander activé)

Paramètres de requête

Nom	Type	Description
site	string	ID du site (compte)
user_id	string	ID de l'utilisateur. Requis si le paramètre tc_id n'est pas défini
token	string	Jeton de sécurité

200

{"success":true}

Syntaxe et limitations

• Le json payload est représenté par une clé/valeur pour chaque préférence.

• Chaque propriété de préférence (clé) commence par "preferences." suivi du nom de la préférence : preferences.your_preference_name

• Le nom de la préférence ne doit pas contenir d'espace, de point ni de caractères spéciaux. Son format est [A-Za-z0-9_-]

• La valeur de la préférence peut contenir des espaces, des points, mais pas de caractères spéciaux.

• L'API accepte un maximum de 20 préférences

Exemple de requête

PUT

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

{
  "preferences": {
    "news_monthly": true,
    "news_sales": true
  }
}