系统回调接口(适用于两种模式)

回调是为了让第三方实时的获取用户手环事件而设计的一种信息传输模式。当第三方所属的扫描器检测到了用户的手环,该次事件会尽快的推送给第三方的回调地址,而不用第三方定期的轮询所有用户的手环事件。

回调模式适合有需要实时处理的一些应用场景,比如说利用健身房门口的扫描器扫描到用户手环的事件来对对应的健身卡计次。需要注意的是,华米开放平台定义了统一的第三方回调接口,第三方需要根据该规范进行实现。

华米开放平台会按照下面的规范post消息到第三方的回调地址。

回调接口规范

POST https://api-beacon.huami-inc.com
Content-Type:application/json
Encoding: UTF-8

消息示例

[
  {
"eventType": "Swipe", /*事件类型*/
    "openId":"880f10000002", /*手环对应人员的华米开放id, 在ToB模式下,为手环的mac地址*/
    "deviceId":"88CC5224060006C4", /*手环的唯一标识,在ToB模式下为空*/
    "scannerId":"880f10000000", /*扫描器的唯一标识*/
    "collectionType":"hbeacon", /*事件类型*/
    "timestamp":"1460359584621", /*事件发生的时间戳(Epoch),精度为秒*/
"message": "{\"rssi\":\"94\", \"heartrate\":\"75\", \"stepCount\":\"775\", \"idle\":\"true\", \"buttonPressed\":\"true\", \"buttonReleased\":\"true\"}" /*escaped json字符串,用于传递额外的手环信息,如信号强度(rssi)情况等*/
  },
  {
"eventType": "Swipe",
    "openId":"880f1000000b",
    "deviceId":"88CC5224060006C5",
    "scannerId":"880f10000000",
    "collectionType":"hbeacon",
    "timestamp":"1460359584624",
"message": "{\"rssi\":\"84\", \"heartrate\":\"85\"}"
  }
]

results matching ""

    No results matching ""