API description
This API is used to configure the linkage between a device and the pages pushed to users via the Shake-Nearby feature. The ID list of the pages to be linked to the device needs to be input (the old pages linked to the device are directly cleared).
The ID list of the pages can be empty. When list is empty, all linkages with the device are cleared.
After the configuration, the linked pages are displayed when users use the Shake-Nearby feature within the signal range of the device.
After applying for the device ID, you can directly configure the linked pages using the API.
If multiple pages are linked to the device, the pages are pushed to users randomly. A maximum of 30 pages can be configured for a device.
API Request Format
HTTP request method: POST (use the HTTPS protocol)https://api.weixin.qq.com/shakearound/device/bindpage?access_token=ACCESS_TOKEN
POST data format: json
POST data example:
{
"device_identifier":{
"device_id":10011,
"uuid":"FDA50693-A4E2-4FB1-AFCF-C6EB07647825",
"major":1002,
"minor":1223
},
"page_ids":[12345, 23456, 334567]
}
Parameters
| Parameter | Required | Description |
|---|---|---|
| access_token | Yes | The credential for calling the API |
| page_ids | Yes | List of pages to be linked |
| device_identifier | Yes | The device ID for the specified page |
| device_id | Yes | Device ID. If UUID+major+minor is entered, device ID is optional. If both are entered, device ID is preferred. |
| UUID, major, minor | Yes | If device ID is entered, this parameter is optional. If device ID is left empty, all the three parts of the parameter are required. |
Response
Example of JSON packet returned for a successful request:
{
"data": {
},
"errcode": 0,
"errmsg": "success."
}