跳转到内容
交付 API
在围绕某项功能进行规划之前,请先查看功能状态。

参考

浏览器端点

访客的浏览器直接调用的端点,用于表单、聊天机器人和页面浏览量统计。

本页面由英文翻译而来。如有任何差异,以英文版本为准。 阅读英文版

这些端点不需要令牌。仅当请求的 Origin 标头是您环境已注册的网站源时,Atlas 才会接受请求;其他任何请求都会得到 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 后重试。达到 80 条消息后返回 409 CONVERSATION_FULL。聊天小组件会为您处理这一切。

POST /analytics/views,请求体为 { "path": "/about" },返回 204。请在每次页面加载和客户端导航之后,使用 fetch(…, { keepalive: true }) 发送。跳过预览和机器人。

Atlas 仅按路由保存每日计数:没有 Cookie,没有 IP 地址,没有访客标识符。