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

新增用户事件

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

URL

POST https://{app_domain}/callback

请求头

Authorization: Bearer {access_token}

请求参数

以下请求参数以企业实际配置的身份同步参数为准，企业管理员可以参考9设置同步至目标应用的属性。

表1 请求参数

参数

固定参数

参数类型

描述

username

是

String(100)

用户名。

name

是

String(40)

用户姓名。

organizationId

是

String

组织机构ID。

password

是

String

密码。

disabled

是

Boolean

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

firstName

否

String(20)

名字。

middleName

否

String(20)

中间名。

lastName

否

String(20)

姓氏。

mobile

否

String

手机号。

email

否

String

邮箱地址。

extAttr1

否

--

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

extAttr2

否

--

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

响应参数

表2 响应参数

参数

参数类型

描述

id

String(50)
  • 下游企业应用创建用户成功后，生成的用户ID，并回传至OneAccess，作为该用户的唯一标识。
  • 在修改、删除用户时，传递id至下游应用，需下游应用保持一致，如果不一致，后面接口返回的id会覆盖之前的id。

请求示例

  • 启用消息签名和加密的请求示例： 
    {
	"nonce": "AmgjjEAJbrMzWmUw",
	"timestamp": 1509384....,
	"eventType": "CREATE_USER",
	"data": "6lu6gxrdJIXEWxQhUa3UqsXHWsDZ5LTAo/xU3zhjq9H3syCuFYDYKg==",
	"signature": "K08yDiTEc094KoccOY+VYLQFxxQ="
}
  • 请求包体data解密后的JSON字符串格式： 
    {
	"username": "zhangsan",
	"name": "张三",
	"mobile": "1899876....",
	"email": "zhangsan@test.com",
	"organizationId": "391551e8-160f-4993-8177-e7b9c5f6....",
	"extAttr1": "value",
	"extAttr2": "value"
}

响应示例

状态码：200

请求成功

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