API Description

Obtains device information, including UUID, major, minor, distance, openID, and other information.

API Request Format

HTTP request method: POST (use the HTTPS protocol)https://api.weixin.qq.com/shakearound/user/getshakeinfo?access_token=ACCESS_TOKEN
POST data format: json
POST data example:


Parameter Required Description
access_token Yes The credential for calling the API
ticket Yes The ticket of Shake Nearby can be obtained in the URL that is popped up. The ticket takes effect for 30 minutes. A new ticket will be generated for each shake.
need_poi No Whether to return the store poi_id. 1: Yes; Other values: No. For more store related information, see store related API documents.


Example of JSON packet returned for a successful request:

    "data": {
        "page_id ": 14211,
        "beacon_info": {
            "distance": 55.00620700469034,
            "major": 10001,
            "minor": 19007,
            "uuid": "FDA50693-A4E2-4FB1-AFCF-C6EB07647825"
        "openid": "oVDmXjp7y8aG2AlBuRpMZTb1-cmA",
        " poi_id":1234
    "errcode": 0,
    "errmsg": "success."


Parameter Description
beacon_info Device information, including UUID, major, minor, and distance
UUID, major, minor UUID, major, minor
distance Distance between Beacon signal and mobile (in meters)
page_id Unique ID of the page
openid ID that uniquely identifies a user under merchant AppID
poi_id Store ID. If any, it will return the store ID, and otherwise it will not be returned in JSON format.