REST API v4: POST /events/webshop/cart/identified

Deze methode stelt je in staat om een cart identified event te registreren. Dit is een HTTP POST methode naar het volgende adres:

https://api.copernica.com/v4/events/webshop/cart/identified

Deze POST call triggert een cart identified event. De verwerking van dit event hangt af van de configuratie van je account. Naar aanleiding van deze POST call zal:

  • Het event worden gelogd
  • De bijbehorende opvolgacties worden uitgevoerd

Parameters

De volgende parameters moeten verplicht worden meegegeven aan dit endpoint:

  • id: De ID van de winkelwagen. (verplicht)
  • Minimaal een van de volgende parameters moet worden verstrekt:
    • email: Het e-mailadres van de eigenaar van de winkelwagen. (optioneel)
    • profile: Het profiel-ID van de eigenaar van de winkelwagen. (optioneel)
    • subprofile: Het subprofiel-ID van de eigenaar van de winkelwagen. (optioneel)

Naast de verplichte parameters kunnen aan dit evenement extra attributen worden toegevoegd die gebruikt kunnen worden in bijvoorbeeld opvolgacties. Extra attributen kunnen bijvoorbeeld specifieke gebruikersinformatie bevatten.

Geaccepteerde formaten

De API-call accepteert zowel JSON-data als traditionele POST-data (application/x-www-form-urlencoded). Hieronder staan voorbeelden van beide formaten.

Voorbeeld met JSON

POST /v4/events/webshop/cart/identified HTTP/1.1
Host: api.copernica.com
Authorization: Bearer your-access-token
Content-Length: 90
Content-Type: application/json

{
    "id": "cart123",
    "email": "john.doe@example.com",
}

Voorbeeld met URL-gecodeerde data

POST /v4/events/webshop/cart/identified HTTP/1.1
Host: api.copernica.com
Authorization: Bearer your-access-token
Content-Length: 59
Content-Type: application/x-www-form-urlencoded

id=cart123&email=john.doe@example.com

Voorbeeld met PHP

// Vereiste scripts
require_once('copernica-rest-api.php');

// Verander dit naar je access token
$api = new CopernicaRestAPI("your-access-token", 4);

// Voer het verzoek uit
$api->post("/events/webshop/cart/identified", array(
    'id'       => 'cart123',
    'email'    => 'john.doe@example.com',
));

Dit voorbeeld vereist de REST API klasse.

Meer informatie