Skip to main content

註冊

POST 

/v1/s2s/register

代合作夥伴的用戶在本平台註冊帳戶,並將企業用戶編號 companyUid 與 email 綁定到該帳戶。 之後其他 API 以 X-Company-Uid header 帶入同一個 companyUid 指定這位用戶。

以本 API 註冊的帳戶:

  1. 不設密碼,用戶無法直接登入本平台,也無法以忘記密碼重設
  2. 不寄送註冊驗證信,流程結束時帳戶直接啟用
  3. 本平台不會直接通知這類用戶,對終端用戶的通知由合作夥伴自行處理

同意條款​

必須帶入專案的全部同意條款,多一筆或少一筆都會被拒絕,且每一筆的 isAgreed 都必須為 true。

條款清單由取得專案啟用中的同意條款取得,id 與 version 分別沿用回傳的 id 與 activeVersion.version; version 必須是目前啟用中的版本。

條款內容的呈現與同意時點的取得由合作夥伴在自己的介面完成,本平台只留存同意紀錄。

重送與冪等​

以同一把 X-Idempotency-Key 重送時,回傳第一次呼叫的結果,不會重複執行。

換一把 X-Idempotency-Key 重送時會重新檢查:同一個 companyUid 已以同一個 email 完成註冊時, 回傳錯誤代碼 SECURITY2183(已以相同信箱完成註冊),不會重複建戶;email 不同則以其他錯誤代碼拒絕。

連線中斷而不確定是否成功時,建議以原本的 X-Idempotency-Key 重送;若收到 SECURITY2183,代表該用戶已註冊完成,可視為註冊成功。

Request​

Responses​

回應