API - Segment Customer

API - Segment Customer

 Pour être informés de toutes les mises à jour concernant l’API v2 de SPREAD, inscrivez-vous ici : https://social-sb.com/z/newsletter-api-v1-v2

Méthodes disponibles

 

GET Segment Customer

Récupère les profils appartenant à un segment

GET ⇒ social-sb.com/api/v2/segments-customers/{segment_id}

Paramètres obligatoires :

  • "segment_id" : l'identifiant SPREAD du segment

Paramètres complémentaires :

Aucun

Réponse :

Si GET ok alors

"segment": { "id": "6215", "customers": [ { "customerId": "14985899" }, { "customerId": "15134089" } ] }, "count": 2, "nextPageUrl": "http://:social-sb.com/api/v2/segments-customers?startAt=2"

Sinon, affichage d'un message d'erreur

 

Exemple d'appel PHP :

$curl = curl_init(); curl_setopt($curl, CURLOPT_URL, "https://social-sb.com/api/v2/segments-customers/123456"); // Auth avec la clé publique et la clé privée (voir dans Paramétrage > Tracker) curl_setopt($curl, CURLOPT_USERPWD, "clef_public:cle_privee"); curl_setopt($curl, CURLOPT_RETURNTRANSFER, true); $curl_return = curl_exec($curl); var_dump($curl_return); curl_close($curl);

Faire une recherche précise :

Il est possible d'affiner la liste retournée en passant des paramètres GET. 

Les paramètres sur la pagination :

  • "startAt" ⇒ permet de commencer la liste des consentements à partir de l'occurence passée en paramètre

  • "maxResult" ⇒ permet de limiter le nombre de consentements remontés par pages (max 5000)