API des événements navigateur — POST /ct

Le point de terminaison /ct reçoit les événements navigateur envoyés par le SDK navigateur de Scanova. Dans la plupart des cas, vous ne l’appelez pas vous-même : le SDK s’en charge. Cette page décrit le format de la requête, pour les intégrations sur mesure et le débogage. URL de base : https://t.scanova.io

Point de terminaison

POST https://t.scanova.io/ct

Aucun en-tête d’authentification n’est requis. Les requêtes sont validées en comparant l’en-tête Origin ou Referer à la liste Allowed Domains du site.

Requête

En-têtes :

Content-Type: application/json
Origin: https://yoursite.com

Corps :

{
  "event_id": "f9ac7db6-f900-4d8e-8918-c846834195a8",
  "site_id": "YOUR_SITE_ID",
  "event_type": "cta_click",
  "scan_session_id": "7ad26d4f-3181-4ef8-b6ca-b8f59499dd43",
  "web_session_id": "2d0c328a-01d0-4010-85f4-f327130d1bd4",
  "visitor_id": "363fe851-7d8f-4090-902f-0f5a462829f5",
  "page_url": "https://yoursite.com/pricing",
  "referrer": "https://yoursite.com/",
  "timestamp": "2026-05-13T10:00:00.000Z",
  "device": {
    "user_agent": "Mozilla/5.0 ...",
    "screen_width": 1440,
    "screen_height": 900,
    "language": "en-US"
  },
  "metadata": {
    "button_text": "Start Free Trial",
    "section": "pricing"
  }
}

Champs

Champ	Type	Obligatoire	Description
`site_id`	chaîne	Oui	Identifiant du site de suivi
`event_type`	chaîne	Oui	Nom de l’événement en snake_case
`event_id`	chaîne UUID	Non	Identifiant de déduplication. Généré si vous l’omettez.
`scan_session_id`	chaîne UUID	Non	Identifiant d’attribution du scan
`web_session_id`	chaîne UUID	Non	Identifiant de session navigateur (30 minutes)
`visitor_id`	chaîne UUID	Non	Identifiant de visiteur durable (cookie d’un an)
`page_url`	chaîne	Non	URL de la page en cours
`referrer`	chaîne	Non	URL de provenance
`timestamp`	ISO 8601	Non	Heure de l’événement. Par défaut, celle de réception.
`device`	objet	Non	User-agent, dimensions de l’écran, langue
`metadata`	objet	Non	Données libres. 10 Ko et 5 niveaux au maximum.
`consent`	chaîne	Non	`granted`, `denied` ou `pending`

Réponse

Succès (200) :

{
  "event_id": "f9ac7db6-f900-4d8e-8918-c846834195a8"
}

Réponses d’erreur :

Statut	Cause
`400`	Champ obligatoire manquant ou `site_id` invalide
`403`	L’`Origin` ou le `Referer` de la requête ne figure pas dans les Allowed Domains du site
`413`	Le contenu dépasse la taille autorisée
`422`	Erreur de validation d’un champ
`429`	Limite de débit dépassée (100 requêtes par minute et par IP)

CORS

Le point de terminaison /ct prend en charge le CORS. Les requêtes navigateur venant des domaines autorisés sont acceptées avec :

Access-Control-Allow-Origin: <origin>
Access-Control-Allow-Methods: POST, OPTIONS

Les requêtes préalables (OPTIONS) renvoient 204 accompagné des en-têtes CORS adéquats.

Point de terminaison de lot

Pour envoyer plusieurs événements navigateur en une seule requête :

POST https://t.scanova.io/collect/batch

Le corps de la requête enveloppe un tableau :

{
  "events": [
    { "site_id": "...", "event_type": "pageview", ... },
    { "site_id": "...", "event_type": "scroll", "metadata": { "scroll_depth": 25 } }
  ]
}

Jusqu’à 100 événements par requête de lot.

Vue d'ensemble

SDK navigateur

Côté serveur

Référence API

Ressources

API des événements navigateur — POST /ct

Point de terminaison

Requête

Champs

Réponse

CORS

Point de terminaison de lot

​Point de terminaison

​Requête

​Champs

​Réponse

​CORS

​Point de terminaison de lot

Point de terminaison

Requête

Champs

Réponse

CORS

Point de terminaison de lot