Aller au contenu
API Delivery
Avant de compter sur une fonctionnalité, consultez l'état des capacités.

Référence

Points d'accès navigateur

Les points d'accès que les navigateurs de vos visiteurs appellent directement pour les formulaires, le chatbot et les compteurs de pages vues.

Cette page a été traduite de l'anglais. En cas de divergence, la version anglaise fait foi. Lire en anglais

Ces points d’accès n’utilisent aucun jeton. Atlas n’accepte une requête que si son en-tête Origin correspond à l’origine enregistrée du site web de votre environnement ; toute autre requête reçoit 403 ORIGIN_DENIED. Le CORS est limité à cette origine.

https://<delivery host>/v1/public/environments/{environmentId}
Méthode et chemin Objet
GET /forms/{formKey} Définition du formulaire, paramètres et challenge à afficher
POST /forms/{formKey}/submissions Envoi. Voir Formulaires et leads pour le corps de la requête
Méthode et chemin Objet
GET /bots/{botKey} Apparence et déclencheurs
POST /bots/{botKey}/conversations Démarrer : { path?, challengeToken? } → { conversationId, secret, messages }
POST /bots/{botKey}/conversations/{id}/messages Envoyer : { secret, text? (≤ 1,000 chars), choice?, challengeToken? }

428 BOT_CHALLENGE_REQUIRED demande au navigateur de terminer Turnstile et de réessayer. 409 CONVERSATION_FULL après 80 messages. Le widget de chat gère tout cela pour vous.

POST /analytics/views avec { "path": "/about" } renvoie 204. Envoyez-le après chaque chargement de page et chaque navigation côté client avec fetch(…, { keepalive: true }). Ignorez les aperçus et les bots.

Atlas ne stocke que des compteurs quotidiens par route : ni cookies, ni adresses IP, ni identifiants de visiteurs.