修改用戶資訊

模板

全域

單點登錄

用戶

組織

群組

修改用戶資訊

請求說明

POST  http://[SERVER:9022]/v1/user/user_update?access_token={access_token}

請求參數

欄位	類型	是否必填	說明
access_token	string	Y	認證的token
org_id	string	Y	組織id
account_id	string	Y	帳號id
nick_name	string	Y	昵稱
phone	string	Y	手機號
mobile_prefix	string	N	國碼（如，中國：86）
email	string	N	郵箱
display_in_org	boolean	N	是否展示到通訊錄 •true：是 •false：否
main_dept	string	N	主部門（多個部門中其中一個）
dept_ids	string[]	N	部門（一個員工可屬於多個部門）
post_id	string	N	崗位id
gender	string	N	性別
first_work_date	date	N	首次工作時間yyyy-MM-dd
join_date	date	N	入職時間yyyy-MM-dd
regular_date	date	N	转正日期yyyy-MM-dd
probation_date	date	N	试用期到期时间yyyy-MM-dd

請求示例：

json

{
  "org_id": "1000000",
  "account_id": "200200021",
  "nick_name": "xxxxxxx1",
  "gender": 1,
  "mobile_prefix":"86",
  "phone": "",
  "email": "1231414324@qq.com",
  "display_in_org":true,
  "main_dept":"1",
  "dept_ids":["1","2"],
  "post_id":"1",
  "first_work_date":"",
  "join_date":"",
  "regular_date":"",
  "probation_date":""
}

返回結果示例

{
  "code": 0, 
  "msg": "ok",
   "data":
     {
      "org": "companyA",
      "org_id":"1000000",
      "account_id": "200200021", // 帳號ID
      "account": "kkk666",
      "nick_name": "kingsley",
      "status": "1",
      "is_online": false,
      "mobile_prefix":"86",
      "phone": "13610117012",
      "email": "13610117012@qq.com",
      "gender": 1,
      "avatar":"http://...",
      "reg_time":"2024-12-12 15:53:07"
      }
}

結果欄位說明

欄位	類型	說明
data		用戶列表
org	string	組織名稱
org_id	string	組織id
account_id	string	用戶id
account	string	用戶帳號
nick_name	string	昵稱
status	int	“1”：正常，“2”：禁用，“3”：離職
is_online	boolean	是否線上 •true：線上 •false：離線
mobile_prefix	int	手機號碼首碼：86
phone	string	手機號碼
email	string	邮箱
gender	int	性別，“1”：男，“2”：女
avatar	string	用戶頭像地址
reg_time	date	註冊時間yyyy-MM-dd HH: mm:ss

狀態碼說明

code	message	說明
100060	Invalid org or account	无效的组织或用户账号
100061	mobile already exist error	手機號已存在
100062	Invalid mobile number	無效的手機號
100063	email already exist error	郵箱已存在
100064	Invalid email	無效的郵箱
100065	Invalid params	參數錯誤（其他參數不合法）
更多通用錯誤碼