註冊
POST/v1/s2s/register
代合作夥伴的用戶在本平台註冊帳戶,並將企業用戶編號 companyUid 與 email 綁定到該帳戶。
之後其他 API 以 X-Company-Uid header 帶入同一個 companyUid 指定這位用戶。
以本 API 註冊的帳戶:
- 不設密碼,用戶無法直接登入本平台,也無法以忘記密碼重設
- 不寄送註冊驗證信,流程結束時帳戶直接啟用
- 本平台不會直接通知這類用戶,對終端用戶的通知由合作夥伴自行處理
同意條款
必須帶入專案的全部同意條款,多一筆或少一筆都會被拒絕,且每一筆的 isAgreed 都必須為 true。
條款清單由取得專案啟用中的同意條款取得,id 與 version 分別沿用回傳的 id 與 activeVersion.version;
version 必須是目前啟用中的版本。
條款內容的呈現與同意時點的取得由合作夥伴在自己的介面完成,本平台只留存同意紀錄。
重送與冪等
以同一把 X-Idempotency-Key 重送時,回傳第一次呼叫的結果,不會重複執行。
換一把 X-Idempotency-Key 重送時會重新檢查:同一個 companyUid 已以同一個 email 完成註冊時,
回傳錯誤代碼 SECURITY2183(已以相同信箱完成註冊),不會重複建戶;email 不同則以其他錯誤代碼拒絕。
連線中斷而不確定是否成功時,建議以原本的 X-Idempotency-Key 重送;若收到 SECURITY2183,代表該用戶已註冊完成,可視為註冊成功。
Request
Responses
- 200
回應