POST/api/public/access-request/email/verify

核實電郵發出嘅代碼,並為之後嘅存取申請發出確認權杖。

傳送`verification_id`(嚟自`start-verification`)、同一樣嘅`email`,以及六位數嘅`code`。成功嘅話,回應會包含`verified: true`,以及一個您需要透過`POST /api/public/access-request`提交存取申請嗰陣一齊傳送嘅`verification_token`。 如果代碼錯誤或者已過期,`verification_id`唔相符,或者電郵地址唔同,就會導致400 `VERIFY_FAILED`。到時候請申請一個新代碼。呢個權杖只對呢個電郵地址有效,唔應該出現喺URL或者記錄入面。 每個IP地址最多15分鐘內10次請求。

概覽

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

身份驗證同安全保障

唔需要身份驗證

冪等: 唔係

參數

verification_id(body, string,必填)— 嚟自`start-verification`嘅`verification_id`
email(body, string,必填)— 同申請代碼嗰時一樣嘅電郵地址
code(body, string,必填)— 電郵入面嘅六位數代碼

請求範例

{"verification_id":"<UUID>","email":"max@example.com","code":"123456"}

回應範例

{"ok":true,"verified":true,"verification_token":"<用於之後存取申請嘅權杖>"}

錯誤代碼

400 VERIFY_FAILED — 代碼、`verification_id`,或者電郵地址唔正確,或者代碼已過期。

已驗證嘅行為

錯誤代碼會回傳400 `VERIFY_FAILED`。成功情況對應產品目錄嘅電郵確認。

公開表單

POST /api/public/contact接收嚟自 Zentor App 網站聯絡表單嘅請求,並轉交畀 Zentor 團隊。POST /api/public/consultation接收嚟自 Zentor App 網站表單嘅咨詢請求。POST /api/public/access-request提交某個套餐(Starter、個別設定或者14日 Demo)嘅存取申請。前提條件係事先已確認嘅電郵地址。POST /api/public/access-request/email/start-verification向指定嘅電郵地址傳送一個有效期為10分鐘嘅六位數確認碼——呢個係存取申請嘅第一步。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啟用新建立嘅用戶帳戶,並設定第一個密碼——透過邀請電郵嘅連結啟動。

相關文章

← 公開表單