建立後台使用者
建立後台使用者
Authentication
每個 /v1 請求都必須帶 X-Client-Id、X-Timestamp、X-Nonce 與 X-Signature 四個標頭。X-Signature 是以 client secret 對 canonical string 做 HMAC-SHA256 後的 Base64。canonical string 的組成、可複製的簽章範例與 401 排查步驟，請參閱「驗證與簽章」。
Request
帳號，用於登入後台。建立時必填，省略回傳 400 account_required；只能在建立時設定，更新後台使用者無法改帳號。同租戶內不能重複，重複會回傳 400 account_already_used；重複比對不分大小寫，也會忽略前後空白，所以 ABC 與 abc 視為同一個帳號。長度上限 50 字元，超過回傳 400 account_too_long。
姓名。建立時必填，省略回傳 400 name_required。長度上限 30 字元，超過回傳 400 name_too_long。
電子郵件。建立時必填，省略回傳 400 email_required。長度上限 100 字元，超過回傳 400 email_too_long。
登入密碼。建立時必填，省略回傳 400 password_required。
角色序號，必須指向呼叫端所屬租戶的既有角色，透過 GET /v1/internal-roles 取得合法的 id。建立時為必填欄位；省略、帶入不存在的 id，或帶入其他租戶的 id，一律回傳 400 invalid_role_id（三種情況統一回同一個代碼）。
ERP 端的使用者代碼，僅供你端對照使用，本 API 不會拿它去比對或去重。省略視為空字串。長度上限 50 字元，超過回傳 400 outer_sys_code_too_long。
Response
新增或更新成功後，該筆資料的 id。