Salt la conținut
Pandus
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.