跳到內容
Delivery 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 位址、沒有訪客識別碼。