REST API v4: POST /events/cart/add

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

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

Deze POST call triggert een cart add event. Echter, hoe dit event precies wordt verwerkt 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)
  • sku: De SKU (Stock Keeping Unit) van het product dat wordt toegevoegd. (verplicht)
  • count: Het aantal van het product dat wordt toegevoegd. (verplicht)

Naast de verplichte parameters kunnen aan dit evenement extra attributen worden toegevoegd die gebruikt kunnen worden in bijvoorbeeld opvolgacties. Extra attributen kunnen bijvoorbeeld productinformatie 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/add HTTP/1.1
Host: api.copernica.com
Authorization: Bearer your-access-token
Content-Length: 71
Content-Type: application/json

{
    "id": "cart123",
    "sku": "PROD001",
    "count": 2,
    "additional_attribute": "value"
}

Voorbeeld met URL-encoded data

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

id=cart123&sku=PROD001&count=2

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/add", array(
    'id'       => 'cart123',
    'sku'      => 'PROD001',
    'count'    => 2,
    'additional_attribute' => 'value'
));

Dit voorbeeld vereist de REST API klasse.

Meer informatie