POST/api/public/contact

接收嚟自 Zentor App 網站聯絡表單嘅請求,並轉交畀 Zentor 團隊。

必填欄位係`name`(2–120個字)、`email`(有效電郵地址)、`message`(10–3000個字),以及必須設定為`true`嘅`consentGiven`。可以選擇傳送`company`、`phone`同`topic`。成功嘅話,伺服器會以`{"ok":true}`同一條確認訊息回應。 如果必填欄位缺失或者無效,或者缺少同意,端點就會以400 `VALIDATION_ERROR`回應;`details`欄位會列出各項具體錯誤,方便您標記相應嘅輸入欄位。每次成功提交都會建立一個新請求。所以,請喺收到回應之前停用提交按鈕,唔好自動重試呢個呼叫。 每個IP地址最多15分鐘內10次請求。另外Zentor嘅存取規則(IP、國家同電郵域名規則)都適用;被拒絕嘅呼叫會收到403。

概覽

調用:POST /api/public/contact。此端點屬於 Zentor App API 的「公開表單」組別。 此端點可公開存取,毋須身份驗證。 此調用並非冪等:每次成功調用均會再次觸發有關操作。 必填參數:name (請求主體), email (請求主體), message (請求主體), consentGiven (請求主體)。 選填參數:company (請求主體), phone (請求主體), topic (請求主體)。 已記錄的錯誤情況:400 VALIDATION_ERROR。 下方的範例回應展示 JSON 格式成功回應的結構。

身份驗證同安全保障

唔需要身份驗證

冪等: 唔係

參數

name(body, string,必填)— 姓名,2–120個字
email(body, string,必填)— 有效嘅電郵地址
message(body, string,必填)— 訊息,10–3000個字
company(body, string)— 公司(可選)
phone(body, string)— 電話號碼(可選)
topic(body, string)— 查詢主題(可選)
consentGiven(body, boolean,必填)— 資料保護同意,必須係`true`

請求範例

{"name":"Max Mustermann","email":"max@example.com","message":"您嘅訊息(最少 10 個字)","consentGiven":true}

回應範例

{"ok":true,"message":"Ihre Anfrage wurde übermittelt."}

錯誤代碼

400 VALIDATION_ERROR — 必填欄位缺失或者無效,或者缺少資料保護同意。`details`包含各項具體嘅錯誤訊息。

已驗證嘅行為

完整資料會回傳200;缺少必填欄位或者缺少同意就會回傳400 `VALIDATION_ERROR`。

公開表單

POST /api/public/consultation接收嚟自 Zentor App 網站表單嘅咨詢請求。POST /api/public/access-request提交某個套餐(Starter、個別設定或者14日 Demo)嘅存取申請。前提條件係事先已確認嘅電郵地址。POST /api/public/access-request/email/start-verification向指定嘅電郵地址傳送一個有效期為10分鐘嘅六位數確認碼——呢個係存取申請嘅第一步。POST /api/public/access-request/email/verify核實電郵發出嘅代碼,並為之後嘅存取申請發出確認權杖。GET /api/public/access-request/payment-status指出目前存取申請可以用嘅付款方式(PayPal、Stripe)。GET /api/public/access-request/paypal/config回傳付款步驟所需嘅公開 PayPal 設定(啟用狀態、模式、貨幣)。POST /api/public/access-request/paypal/create-order為所選套餐建立一個 PayPal 訂單。POST /api/public/access-request/paypal/capture-order完成(捕獲)之前建立並由買家喺 PayPal 結帳頁面批准嘅訂單。金額只由伺服器決定。POST /api/public/access-request/stripe/create-checkout為所選套餐建立一個 Stripe 結帳會話。POST /api/public/activate-account啟用新建立嘅用戶帳戶,並設定第一個密碼——透過邀請電郵嘅連結啟動。

相關文章

← 公開表單