Documentația Pandus SDK
Evenimente de server
Trimite cumpărări, rambursări și alte evenimente din backend către Pandus SDK prin API-ul REST: endpoint, token, conținut, limite și legarea de o vizită.
Actualizat:
Comenzile, rambursările și alte evenimente din backend pot ajunge la Pandus de pe serverul tău, ca în GA4 Measurement Protocol. Un blocator din browser nu le poate pierde.
Endpoint
POST https://pandus.online/api/v1/sites/{site}/events
Authorization: Bearer YOUR_TOKEN
Content-Type: application/json
Creează tokenul în API și webhookuri. Folosește un token cu write sau unul făcut doar pentru asta: „Doar trimite evenimente de pe serverul tău”. Referința completă este în documentația API.
Conținutul cererii
{
"events": [
{
"name": "purchase",
"client_id": "k3j9x0a1b2c3d4e5f6g7",
"page": "/checkout/thank-you",
"params": {
"transaction_id": "A-1042",
"value": 449,
"currency": "RON",
"items": [{ "item_id": "kettle-1", "item_name": "Kettle", "price": 449, "quantity": 1 }]
}
}
]
}
| Câmp | Note |
|---|---|
name |
Obligatoriu, aceleași reguli ca în browser |
params |
Până la 25 de parametri; items pentru e-commerce |
client_id |
Din cookie-ul _pandus_id, dacă vizitatorul și-a dat acordul: leagă evenimentul de vizita lui |
session_id |
Opțional |
user_id |
Doar ca hash SHA-256 |
timestamp_ms |
Opțional; în ultimele 72 de ore, altfel ora sosirii |
page |
O cale sau un URL al site-ului tău |
Până la 25 de evenimente pe cerere. Răspunsul este 202 cu numărul de evenimente acceptate; apar în rapoarte într-un minut. Valorile care arată ca un e-mail, un telefon sau un număr de card sunt eliminate. Evenimentele de server se numără în cota lunară de evenimente a planului.
Exemplu cu curl
curl -X POST https://pandus.online/api/v1/sites/SITE_ID/events \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Content-Type: application/json" \
-d '{"events":[{"name":"refund","params":{"transaction_id":"A-1042","value":449,"currency":"RON"}}]}'
Consimțământ
Trimite client_id doar pentru vizitatorii care au acceptat analiza; fără el, evenimentul se numără, dar nu este legat de o vizită.
Citirea cifrelor
Rapoartele de analiză sunt disponibile prin GET /api/v1/sites/{site}/analytics/{report}: vezi Analiză.
Pandus SDK și scanerul sunt verificări automate, nu un audit complet și nici consultanță juridică. SDK-ul nu schimbă nimic pe site și nu stabilește care vizitatori folosesc tehnologii asistive.