Skip to content

Latest commit

 

History

History
165 lines (144 loc) · 5.12 KB

api_bongday.md

File metadata and controls

165 lines (144 loc) · 5.12 KB

###说明 该接口返回某一个 bongday 的详细用户数据。根据用户的活动类别,总共分为 5 类,列在了下面的表格中。

type 对应的行为
1 睡眠
2 bong
3 非bong
4 摘下
5 充电
6 异常

在这 5 类运动中,bong非bong睡眠各自下面还有子类,详见下表:

#####bong(燃烧脂肪态) 在 bong 态下,也就是手环震动,手环 LED 指示灯开始点亮的状态下,用户进入了燃烧脂肪的运动状态。该状态下总共有4个子状态,type为2,subType返回值为1-4:

subType返回值 对应运动 说明
1 热身运动 和字面意思相同,运动强度最轻的一类运动。
2 健走 强度稍高。
3 运动 球类等运动。
4 跑步 有氧跑步运动。
5 游泳 游泳等水中运动。
6 自行车 骑车等。
#####非bong(相对静止态),type为3,subType返回值为1-2:
非bong下共有2个子状态:
subType返回值 对应运动 说明
1 静坐 例如坐在椅子上办公。
2 散步 速度相当于走路。
3 交通工具 开车、乘公交等快速交通工具。

#####睡眠状态,type为1,subType返回值为1-3:

subType返回值 对应运动 说明
1 深睡眠 深度睡眠
2 浅睡眠 浅度睡眠
3 清醒 一次睡眠中的清醒状态

###调用方法

#####正常调用 地址:/1/bongday/blocks/yyyyMMdd?uid=uid&access_token=token_get_from_oauth

参数 说明
yyyyMMdd 查询的那一日,例子 20140101
uid 认证中返回的 uid
access_token 认证中返回的 token

#####jsonp 调用 地址: /1/bongday/blocks/yyyyMMdd/jsonp?uid=uid&callback=func_name&access_token=token_get_from_oauth

参数 说明
yyyyMMdd 同上
uid 同上
callback 回调函数名
access_token 同上

###返回数据

{
    "code": "200", 
    "message": "成功标示!", 
    "value": [
        {
            "startTime": "2014-04-29 09:40:00", 
            "endTime": "2014-04-29 12:20:00", 
            "type": 5
        }, 
        {
            "startTime": "2014-04-29 12:21:00", 
            "endTime": "2014-04-29 16:12:00", 
            "type": 1, 
            "dsNum": 194, 
            "lsNum": 38, 
            "wakeNum": 0, 
            "wakeTimes": 0, 
            "score": 2.00
        }, 
        {
            "startTime": "2014-04-29 16:13:00", 
            "endTime": "2014-04-29 20:41:00", 
            "type": 4
        }, 
        {
            "startTime": "2014-04-29 20:42:00", 
            "endTime": "2014-04-29 21:43:00", 
            "type": 2, 
            "distance": 157.32, 
            "calories": 58.95, 
            "steps": 226, 
            "subType": 1, 
        }, 
        {
            "startTime": "2014-04-29 21:44:00", 
            "endTime": "2014-04-29 22:02:00", 
            "type": 2, 
            "distance": 0.00, 
            "calories": 22.66, 
            "steps": 0, 
            "subType": 1, 
        }, 
        {
            "startTime": "2014-04-29 22:03:00", 
            "endTime": "2014-04-29 22:16:00", 
            "type": 3, 
            "distance": 497.71, 
            "calories": 75.25, 
            "steps": 715, 
            "subType": 2, 
            "actTime": 544, 
            "nonActTime": 296
        }, 
        {
            "startTime": "2014-04-29 22:17:00", 
            "endTime": "2014-04-29 22:27:00", 
            "type": 3, 
            "distance": 44.55, 
            "calories": 29.02, 
            "steps": 65, 
            "subType": 1, 
            "actTime": 300, 
            "nonActTime": 360
        }
    ]
}
参数 说明
startTime 该区块的开始时间,例如,用户早起跑步的跑步区块从 8:31 开始。
endTime 该区块的结束时间,例如这个用户跑了 20 分钟,那么区块结束时间是 8:51 分。通过块的划分,可以使用户和开发者均能方便对一天的活动状态做出归纳。
type 该区块的类型,用这个来区分bong和非bong状态。如果这个区段是bong态,则返回值是「2」,如果是比较平静的非bong态,则返回值是「3」。
distance 用户在该区段间走过的距离,单位是米。
speed 用户在该区段的平均运动速度,单位是千米每小时。
calories 用户在这段时间内消耗了多少热量,单位是千焦耳。
steps 该区段的步数,单位是步。
subType 该区段的子运动类型,bong态(当上文中提到的 type 为「2」时)下有4个子类型,具体描述见下,非bong态(type 为「3」时)下有2个子类型,具体描述见下。
actTime 该区段用户的活动时间,单位是秒。
nonActTime 该区段用户的非运动时间,单位是秒。
dsNum 深睡眠时长,单位:分钟
lsNum 浅睡眠时长,单位:分钟
wakeNum 清醒时长,单位:分钟
wakeTimes 清醒次数,单位:次
score 睡眠质量评分

获取多日数据(最多7日)

#####正常调用 地址 1/bongday/blocks/yyyyMMdd/n?uid=uid&access_token=access_token #####jsonp 调用 地址 1/bongday/blocks/yyyyMMdd/n/jsonp?uid=uid&access_token=access_token

#####说明 yyyyMMdd: 起始日期。例子:20140313 n: 从起始日期开始的天书。例子:7