<aside> 💡 Par défaut, la cagnotte SPREAD fonctionne automatiquement. Cette API vous permet d'ajouter des points dans les cagnottes de vos clients.

</aside>

Liste des endpoints disponibles :

/cagnottes/ (POST)

Cette méthode permet d'ajouter des points dans une cagnotte.

Endpoint : https://social-sb.com/api/v2/cagnottes/

Verb : POST

Paramètres obligatoires :

• email : Email du customer (dans le payload "contact")

  OU

  customerId : Identifiant unique SPREAD du customer

• cagnotteAmount : le montant à ajouter à la cagnotte du customer (dans le payload "cagnotte")

Paramètres complémentaires :

Aucun

Réponse :

"customer": {
 "id": "123456",
 "cagnotteAmount": "15"
},
"cagnotte": {
 "cagnotteId": "987",
 "cagnotteLineId": "146964",
 "customerId": "123456",
 "campaignId": null,
 "cagnotteLineDate": "2019-08-29 13:36:52",
 "cagnotteLineValidationDate": "2019-08-29 13:36:52",
 "amount": "5",
 "code": ""
}

Exemple d'appel PHP :

$curl_post_data = array(
    'customer' => array (
        'email' => '[email protected]'
    ),
    'cagnotte' => [
        'amount' => 1
    ]
);
 
$curl_post_data = json_encode($curl_post_data);
 
$curl = curl_init();
curl_setopt($curl, CURLOPT_URL, "<https://social-sb.com/api/v2/cagnottes>");
curl_setopt($curl, CURLOPT_POSTREDIR, CURL_REDIR_POST_ALL);
curl_setopt($curl, CURLOPT_FOLLOWLOCATION, true);
curl_setopt($curl, CURLOPT_HTTPAUTH, CURLAUTH_ANY);
// Auth avec la clé publique et la clé privée (voir dans Paramétrage > Tracker)
curl_setopt($curl, CURLOPT_USERPWD, "clef_public:clef_privee");
curl_setopt($curl, CURLOPT_POSTFIELDS, $curl_post_data );
curl_setopt($curl, CURLOPT_POST, true);
curl_setopt($curl, CURLOPT_VERBOSE, 1);
curl_setopt($curl, CURLOPT_RETURNTRANSFER, true);
$curl_return = curl_exec($curl);
var_dump($curl_return);
curl_close($curl);

/cagnottes/ (GET)

Cette méthode permet de récupérer les cagnottes.

Endpoint : https://social-sb.com/api/v2/cagnottes/

Verb : GET

Paramètres obligatoires :

Aucun