更新後台使用者
更新後台使用者
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 not_found。
Request
姓名。省略保留現有值。長度上限 30 字元,超過回傳 400 name_too_long。
電子郵件。省略保留現有值。長度上限 100 字元,超過回傳 400 email_too_long。
登入密碼。省略表示不改密碼,這是保留原密碼的唯一方式。
角色序號。省略保留現有角色;帶入時必須指向呼叫端所屬租戶的既有角色,否則回傳 400 invalid_role_id。改變這個欄位會立即讓這個使用者既有的登入階段失效(詳見本端點說明);若這個使用者是租戶目前唯一還能登入的系統管理員,把他改成非管理員角色會被拒絕,回傳 409 last_active_admin。
帳號狀態,只接受 Active 或 Inactive(大小寫不敏感),其他值回傳 400 invalid_status。省略保留現有狀態;設為 Inactive 會立即讓這個使用者既有的登入階段失效。若這個使用者是租戶目前唯一還能登入的系統管理員,設為 Inactive 會被拒絕,回傳 409 last_active_admin。
ERP 端的使用者代碼。省略保留現有值。長度上限 50 字元,超過回傳 400 outer_sys_code_too_long。
Response
新增或更新成功後,該筆資料的 id。