브라우저 엔드포인트

이 엔드포인트들은 토큰을 사용하지 않습니다. Atlas는 Origin 헤더가 환경에 등록된 웹사이트 출처인 요청만 받으며, 그 외에는 403 ORIGIN_DENIED를 반환합니다. CORS는 해당 출처로 제한됩니다.

https://<delivery host>/v1/public/environments/{environmentId}

라이브 웹사이트에서

프로덕션 환경에서 이 엔드포인트는 프로덕션이 켜져 있고 서명된 릴리스가 라이브인 동안에만, 그리고 https:// 프로덕션 도메인에서만 응답합니다. 프로덕션이 꺼져 있으면 404 CP_NOT_FOUND, 프로덕션은 켜져 있지만 라이브 릴리스가 없으면 403 CP_PRODUCTION_LOCKED로 응답합니다. 그곳에서 제공되는 폼과 챗봇은 라이브 릴리스에 포함된 버전입니다.

폼

메서드와 경로	용도
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을 완료하고 다시 시도하도록 요청합니다. 메시지가 80개가 되면 409 CONVERSATION_FULL이 반환됩니다. 챗 위젯이 이 모든 것을 대신 처리합니다.

페이지 조회

POST /analytics/views에 { "path": "/about" }를 보내면 204가 반환됩니다. 각 페이지 로드와 클라이언트 측 이동 후에 fetch(…, { keepalive: true })로 전송하세요. 미리보기와 봇은 건너뛰세요.

Atlas는 경로별 일일 집계만 저장합니다. 쿠키, IP 주소, 방문자 식별자는 저장하지 않습니다.