更新客戶帳號
依 id 更新客戶帳號,部分合併——只送有異動的欄位,省略的欄位維持原值。省略 password 表示不改密碼;email、phone 帶空字串會清空。帳號(account)建立後不能修改。status 只接受 Active 或 Inactive,其他值回傳 400 invalid_status;帶入 roleId 時必須是呼叫端所屬租戶的角色,否則回傳 400 invalid_role_id。客戶找不到時回傳 404 company_not_found,帳號找不到(含屬於另一家客戶)時回傳 404 not_found。
改派角色會讓這個帳號在前台的登入階段立即失效,並清空他的購物車,與在後台改派角色相同;把 status 設為 Inactive 也會立即讓他登出。
⚠️ 每一家客戶至少要保留一個生效中的 Boss 帳號。 前台有一整批功能只開放給 Boss 角色(例如管理同公司的帳號、查看全公司的訂單),後台為客戶代客下單也需要客戶有 Boss。若這個帳號是客戶目前唯一生效中的 Boss,把他改成其他角色、或把狀態設為 Inactive,會被拒絕並回傳 409 last_active_boss——請先把另一個帳號改為 Boss。本來就沒有生效中 Boss 的客戶不受這條限制。
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。
要更新的客戶帳號序號。不存在、屬於其他租戶,或不屬於網址上的客戶時,一律回傳 404 not_found。
Request
姓名。省略或只有空白時維持原值;長度上限 30 字元,超過回傳 name_too_long。
電子郵件。省略維持原值,帶空字串會清空;長度上限 100 字元,超過回傳 email_too_long。
手機號碼。省略維持原值,帶空字串會清空;長度上限 100 字元,超過回傳 phone_too_long。
新密碼。省略或只有空白時不改密碼。
改派的角色序號,必須是呼叫端所屬租戶的角色,否則回傳 invalid_role_id。省略維持原角色。改派會讓這個帳號在前台立即登出並清空購物車;若他是客戶唯一生效中的 Boss,改成其他角色會回傳 409 last_active_boss。
帳號狀態,Active 或 Inactive(大小寫不敏感),其他值回傳 invalid_status。省略維持原狀態;設為 Inactive 會立即讓他在前台登出,若他是客戶唯一生效中的 Boss 則回傳 409 last_active_boss。
Response
新增或更新成功後,該筆資料的 id。