建立客戶帳號
在指定的客戶底下建立一個前台登入帳號。account、name、password、roleId 為必填,未帶時分別回傳 400 account_required/name_required/password_required/role_id_required;email、phone 選填,status 省略時為 Active。
account 須為 3–50 個英文字母、數字或連字號(-),或是有效的電子郵件格式,否則回傳 400 invalid_account_format。帳號在整個租戶內不得重複(不分大小寫),不只是同一家客戶——前台登入只看租戶與帳號,所以另一家客戶已經用過的帳號一樣會回傳 400 account_already_used。roleId 必須是呼叫端所屬租戶的角色(見 GET /v1/company-user-roles),否則回傳 400 invalid_role_id。
與在後台建立帳號相同,新帳號會自動產生一組 8 位數字的邀請碼;若貴租戶設定新帳號首次登入不必變更密碼,這裡建立的帳號也比照辦理。這支端點一律視為新增,沒有去重更新:重送同一份資料會因帳號重複而被拒絕。
客戶不存在或屬於其他租戶時回傳 404 company_not_found。
Authentication
每個 /v1 請求都必須帶 X-Client-Id、X-Timestamp、X-Nonce 與 X-Signature 四個標頭。X-Signature 是以 client secret 對 canonical string 做 HMAC-SHA256 後的 Base64。
canonical string 的組成、可複製的簽章範例與 401 排查步驟,請參閱「驗證與簽章」。
Path parameters
要建立帳號的客戶序號。查無此客戶或屬於其他租戶時,一律回傳 404 company_not_found。
Request
登入帳號,必填。3–50 個英文字母、數字或連字號(-),或有效的電子郵件格式,否則回傳 invalid_account_format;長度上限 50 字元,超過回傳 account_too_long。在整個租戶內不得重複(不分大小寫),重複回傳 account_already_used。建立後不能修改。
姓名,必填。長度上限 30 字元,超過回傳 name_too_long。
登入密碼,必填。以雜湊儲存,任何查詢都不會回傳。
電子郵件,選填。長度上限 100 字元,超過回傳 email_too_long。
手機號碼,選填。長度上限 100 字元,超過回傳 phone_too_long。
角色序號,必填,必須是呼叫端所屬租戶的角色,透過 GET /v1/company-user-roles 取得。省略回傳 role_id_required;不存在或屬於其他租戶回傳 invalid_role_id。
帳號狀態,Active 或 Inactive(大小寫不敏感),省略時為 Active。其他值回傳 invalid_status。
Response
新增或更新成功後,該筆資料的 id。