事件通知接口

事件通知接口

竹云IDaaS中WebHook回调接口的请求方式为POST，数据编码为UTF-8，数据格式为JSON。

当事件触发时，竹云IDaaS将用户ID推送到应用系统提供的回调地址上。

1.请求说明

POST

2.请求头

参数名	中文名称	必须	示例值	描述
Authorization	授权	是	String	格式：Bearer
Content-Type	内容类型	是	String	固定值:application/json; charset=utf-8

3.请求包体

请求包体示例

1.创建用户

{ "nonce":"123456", "timestamp":1783610513, "event":"USER_CREATE", "data":"1ojvw2WPvW7LijxS8UvP+rXpPbcLGOmIBNbWetRg7IP0vdhkl", "sign":"111108bb8e6dbce3c9671d6fdb69d15066227608" }

2.修改用户手机号码

{ "nonce":"123456", "timestamp":1783610513, "event":"USER_UPDATE_MOBILE", "data":"1ojvw2WPvW7LijxS8UvP+rXpPbcLGOmIBNbWetRg7IP0vdhkl", "sign":"111108bb8e6dbce3c9671d6fdb69d15066227608" }

请求包体data解密后的数据示例

20200223170310946-34EE-3403BF88A

4.请求参数说明

参数名	类型	描述
nonce	String	随机数。与timestamp结合使用，用于防止请求重放攻击。
timestamp	Integer	时间戳。与nonce结合使用，用于防止请求重放攻击。
event	String	事件类型，参见事件列表
data	String	消息体。解密后为用户ID。
sign	String	消息签名。

5.响应包体

成功示例

HTTP/1.1 200 OK

注：竹云IDaaS仅根据应用系统返回的http状态码判断事件是否推送成功，状态码为200则表示事件推送成功，其他则表示事件推送失败。

6.响应参数

无

获取业务数据接口

事件通知接口是当事件触发时，将用户ID推送到应用系统，如果应用系统需要获取用户其他属性的信息，可以调用竹云IDaaS提供的根据用户id获取用户详情接口获取用户详情。

注：如需调用此接口，需要向管理员申请开通API接口权限。