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.