Event Notification API

Event Notification API

In BambooCloud IDaaS, the WebHook callback API uses the POST method, UTF-8 encoding, and JSON data format.

When an event is triggered, BambooCloud IDaaS pushes the user ID to the callback address provided by the application system.

1. Request Description

POST

2. Request Headers

Parameter Name	Chinese Name	Required	Example Value	Description
Authorization	Authorization	Yes	String	Format: Bearer
Content-Type	Content Type	Yes	String	Fixed value: application/json; charset=utf-8

3. Request Body

Request body example

1. Create User

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

2. Update User Mobile Number

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

Decrypted data example of the request body data

20200223170310946-34EE-3403BF88A

4. Request Parameter Description

Parameter Name	Type	Description
nonce	String	Random number. Used together with timestamp to prevent replay attacks.
timestamp	Integer	Timestamp. Used together with nonce to prevent replay attacks.
event	String	Event type, see Event List
data	String	Message body. After decryption, it is the user ID.
sign	String	Message signature.

5. Response Body

Success example

HTTP/1.1 200 OK

Note: BambooCloud IDaaS determines whether the event push is successful based only on the HTTP status code returned by the application system. A status code of 200 indicates the event push is successful; otherwise, it indicates failure.

6. Response Parameters

None

Get Business Data API

The event notification API pushes the user ID to the application system when an event is triggered. If the application system needs to obtain other attribute information of the user, it can call the BambooCloud IDaaS Get User Details by User ID API.

Note: To call this API, you need to apply to the administrator to enable the API interface permission.