Конечные точки для браузера
Конечные точки, которые браузеры ваших посетителей вызывают напрямую для форм, чат-бота и счётчиков просмотров страниц.
Эта страница переведена с английского. При любых расхождениях действует английская версия. Читать на английском
Этим конечным точкам токен не нужен. Atlas принимает запрос только тогда, когда его заголовок Origin совпадает с зарегистрированным источником сайта вашего окружения; в остальных случаях возвращается 403 ORIGIN_DENIED. CORS ограничен этим источником.
https://<delivery host>/v1/public/environments/{environmentId}| Метод и путь | Назначение |
|---|---|
GET /forms/{formKey} |
Описание формы, настройки и проверка, которую нужно показать |
POST /forms/{formKey}/submissions |
Отправка. Тело запроса см. в разделе Формы и лиды |
Чат-бот
Заголовок раздела «Чат-бот»| Метод и путь | Назначение |
|---|---|
GET /bots/{botKey} |
Внешний вид и триггеры |
POST /bots/{botKey}/conversations |
Начало: { path?, challengeToken? } → { conversationId, secret, messages } |
POST /bots/{botKey}/conversations/{id}/messages |
Отправка: { secret, text? (≤ 1,000 chars), choice?, challengeToken? } |
428 BOT_CHALLENGE_REQUIRED просит браузер пройти Turnstile и повторить запрос. 409 CONVERSATION_FULL после 80 сообщений. Виджет чата обрабатывает всё это за вас.
Просмотры страниц
Заголовок раздела «Просмотры страниц»POST /analytics/views с { "path": "/about" } возвращает 204. Отправляйте его после каждой загрузки страницы и каждого перехода на стороне клиента с помощью fetch(…, { keepalive: true }). Пропускайте предпросмотр и ботов.
Atlas хранит только ежедневные счётчики по маршрутам: никаких файлов cookie, IP-адресов или идентификаторов посетителей.