文档首页/ 应用身份管理服务 OneAccess/ 开发指南/ 通过事件回调方式同步数据至应用/ API/ 修改用户事件
更新时间：2025-08-06 GMT+08:00
查看PDF
分享

修改用户事件

通过该接口将更新的用户同步至应用系统。

URL

POST https://{app_domain}/callback

请求头

Authorization: Bearer {access_token}

请求参数

表1 请求参数

参数

固定参数

参数类型

描述

id

是

String(50)

企业应用的用户ID。

username

是

String(100)

用户名。

name

否

String(40)

用户姓名

firstName

否

String(20)

名字。

middleName

否

String(20)

中间名。

lastName

否

String(20)

姓氏。

organizationId

否

String

组织机构ID。

mobile

否

String

手机号。

email

否

String

邮箱地址。

disabled

是

Boolean

是否禁用，true表示禁用状态，false表示启用（未禁用）。

extAttr1

否

--

扩展属性1，企业扩展的用户属性，以实际情况为准。

extAttr2

否

--

扩展属性2，企业扩展的用户属性，以实际情况为准。

响应参数

表2 响应参数

参数

参数类型

描述

id

String(50)
  • 与表1中的id一致。
  • 当下游企业应用更新用户成功后，回传至OneAccess的用户ID。
  • 需下游应用保持一致，如果不一致，后面接口返回的id会覆盖之前的id。

请求示例

  • 启用消息签名和加密的请求示例： 
    {
	"nonce": "AmgjjEAJbrMzWmUw",
	"timestamp": 15093849585,
	"eventType": "UPDATE_USER",
	"data": "6lu6gxrHydJIXEQhUa3UqsXHWsDZ5LTAo/xU3zhjq9H3syCuFYDYKg==",
	"signature": "K08yDiTEc094KoccOY+VYLQFxxQ="
}
  • 请求包体data解密后的JSON字符串格式。
    根据请求的用户ID参数更新用户信息，将变更的用户属性发送给企业应用。 
    {
	"id": "c3a26dd3-27a0-4dec-a2ac-ce211e10....",
	"username": "zhangs",
	"name": "张三2",
	"mobile": "1867237....",
	"email": "454205....@qq.com",
	"extAttr1": "value",
	"extAttr2": "value"
}

响应示例

状态码：200

请求成功

  • 启用消息签名和加密的响应示例： 
    {
	"code": "200",
	"message": "success",
	"data": "P+rXpWetRg7IP0vdhVgkVwSoZBJeQwY2zhROsJq/HJ+q6tp1qhl9L1+c"
}
  • 响应包体data解密后的JSON字符串格式： 
    {
	"id": "c3a26dd3-27a0-4dec-a2ac-ce211e105f97"
}
父主题： API