Skip to content

通知机制简介

UBI SDK 平台可以主动将用户行为事件推送给接入方。现阶段我们只提供一种事件的通知：用户的行程被分析完成。不论用户提交的行程是否是有效行程，我们都会将分析结果推送给接入方。 用户的行程被分析完成后，UBI SDK 平台发布的事件通知的格式如下所示：

 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
{
  "type": "trip_completion",
  "event_id": "f2b6f7fb-8c05-454b-8eaf-4d19b8ec6c78",
  "app_id": "",
  "user_id": "",
  "org_user_id": "",
  "trip_id": "",
  "status": "normal",    // normal, abnormal or failed
  "abnormal_reason": "", // reason for this trip being abnormal
  "detail": {
    "os": 1,
    "coordinates": "GCJ02",
    "mileage_in_meters": 7859.8479211147205,
    "duration_in_seconds": 1321.6959998607635,
    "avg_speed_in_kilometers_per_hour": 21.408442273407676,
    "max_speed_in_kilometers_per_hour": 67.35599670410157,
    "start_timestamp": 1638498092.502,
    "end_timestamp": 1638499414.198,
    "start_point": {
      "lng": 119.976716,
      "lat": 31.708822
    },
    "end_point": {
      "lng": 119.91846225657571,
      "lat": 31.688833988656402
    },
    "start_poi": "",
    "end_poi": "",
    "score": 100,
    "energy": 218,
    "events": []
  }
}

UBI SDK 平台提供如下两种通知机制：

  1. Webhook: 将事件通过 HTTP POST 请求发送到业务方提供的服务
  2. 消息中间件机制: 将事件通知推送到公有云的消息服务供接入方消费

关于这些通知机制的详细介绍请跳转到对应的文档。