手表设置

# 云端对接方式调用的API

这个API用来设置设备，发送指令，获取一些设备信息/状态

返回值格式:

{
    "ReturnCode":0,
    "Data":{}
}

ReturnCode:

0 - 代表正常
10001/10505 - API处理有错误
10002 - 参数有问题，有遗漏或参数值有问题
10404 - 没有数据

10001/10505/10002 通常代表客户端程序调用有问题，如果自己查不出问题，需联系API开发咨询。 Data 字段根据API不同而不同，有可能没有

如果设备未激活，访问API不会成功，需要传一个参数device_model，加到URL里面 ?device_model=xxx

下发用户设置到设备

URL: /entservice/cmd/userinfo

Method: POST

Params/json:

{
    "device_id":"984612114945605",
    "height":166,
    "weight":66,
    "gender":2,
    "age":66,
    "calibrate_walk":100,
    "calibrate_run":100,
    "wrist_circle":120
}

Note:

性别（gender）：1 男，2 女;
身高（height）：单位厘米;
体重（weight）：单位公斤;
年龄（age）;
calibrate_walk、calibrate_run 请勿修改，默认100
wrist_circle: 腕围，单位毫米，范围80~230

设备实时定位

URL: /entservice/cmd/realtime/location

Method: POST

Params/json:

{
    "device_id":"984612114945605"
}

设备数据一键同步

URL: /entservice/cmd/datasync

Method: POST

Params/json:

{
    "device_id":"984612114945605"
}

设备在线状态

URL: /entservice/device/status

Method: GET

Params: ?device_id={0}

device status:

0-OFFLINE
1-ONLINE
2-UNACTIVE
3-DISABLE
4-NOT EXIST

设备跌倒检测开关

URL: /entservice/cmd/fallcheck

Method: POST

Params/json:

{
    "device_id":"984612114945605",
    "fall_check":true
}

设备自动定位开关

URL: /entservice/cmd/autolocate?device_model=H200A

Method: POST

Params/json:

{
    "device_id":"984612114945605",
    "gps_auto_check":true,
    "gps_interval_time":10,
    "power_mode":2
}

gps_interval_time - unit is minute

power_mode - 可选，设备省电设置：

1 - low耗电
2 - mid耗电
3 - high耗电

这个指令仅对H200生效，其他设备请使用设备数据上传间隔设置

下发通讯录

URL: /entservice/phonebook/sync

Method: POST

Params/json:

{
    "device_id":"984612114945605",
    "phone_book":[
        {
            "name":"小明一",
            "number":"15628457361",
            "sos":true
        },
        {
            "name":"小明二",
            "number":"18577546507",
            "sos":true
        },
        {
            "name":"小明三",
            "number":"13662783623",
            "sos":true
        },
        {
            "name":"小明四",
            "number":"18518931658",
            "sos":false
        }
    ],
    "forbid":1
}

sos - 是否紧急联系人, 要求至少有一个号码是SOS的

forbid - 可选，1 拦截陌生来电, 2 不拦截陌生来电。不传的时候不设置陌生来电拦截

name - 最大24字节

number - 最大20字节

最多设置8个号码

清空通讯录

URL: /entservice/phonebook/clear

Method: POST

Params/json:

{
    "device_id":"869595060004461"
}

设备数据上传间隔设置

URL: /entservice/cmd/datafreq

Method: POST

Params/json:

{
    "device_id":"984612114945605",
    "gps_auto_check":true,
    "gps_interval_time":10,
    "power_mode":2
}

gps_auto_check - 定位开关

gps_interval_time - 定位间隔，unit is minute

power_mode - 可选，设备省电设置：

1 - low耗电;手表放置和进入睡眠的时候会关闭4G模块，无法上传数据，无法接听呼入电话
2 - mid耗电;手表放置的时候不会关闭4G模块，可以上传数据，接听呼入电话；手表进入睡眠的时候会关闭4G模块，无法上传数据，无法接听呼入电话
3 - high耗电;手表放置和进入睡眠的时候，都不会关闭4G模块，数据上传和电话呼入呼出不受影响

翻腕亮屏设置

URL: /entservice/cmd/lcdgesture

Method: POST

Params/json:

{
    "device_id":"984612114945605",
    "open":true,
    "start_hour":0,
    "end_hour":24
}

open - true 打开, false 关闭

开始时间（start_hour） - 开启翻腕亮屏时间, 0 - 23

结束时间（end_hour） - 关闭翻腕亮屏时间, 0 - 24

心率报警设置

URL: /entservice/cmd/hralarm

Method: POST

Params/json:

{
    "device_id":"984612114945605",
    "open":true,
    "high":130,
    "low":50,
    "threshold":3,
    "alarm_interval":10
}

open - true 打开心率报警, false 关闭心率报警

high - 正常心率最高值

low - 正常心率最低值

threshold - 产生几次异常心率，开始报警

alarm_interval - 报警间隔，单位分钟

血氧报警设置

URL: /entservice/cmd/spo2alarm

Method: POST

Params/json:

{
    "device_id":"984612114945605",
    "open":true,
    "low":80
}

open - true 打开血氧报警, false 关闭血氧心率报警

low - 低于此血氧值报警

血压报警设置

URL: /entservice/cmd/bpalarm

Method: POST

Params/json:

{
    "device_id":"866655060067405",
    "open":true,
    "sbp_high":120,
    "sbp_below":80,
    "dbp_high":120,
    "dbp_below":80
}

open - true 打开血压报警, false 关闭血压报警

sbp_high - 高压最高值，单位：mmhg

sbp_below - 高压最低值，单位：mmhg

dbp_high - 低压最高值，单位：mmhg

dbp_below - 低压最低值，单位：mmhg

温度报警设置

URL: /entservice/cmd/temperature/alarm

Method: POST

Params/json:

{
    "device_id":"866655060067405",
    "open":true,
    "high":380,
    "low":350
}

温度值设置需要乘10移除小数，例如：37.5°设置375

血糖报警设置

URL: /entservice/cmd/sugaralarm

Method: POST

Params/json:

{
    "device_id":"866655060067405",
    "open":true,
    "blood_sugar_low":3.5,
    "blood_sugar_high":9.5
}

open - true 打开血糖报警, false 关闭血糖报警

blood_sugar_low - 低于这个值报警

blood_sugar_high - 高于这个值报警

血钾报警设置

URL: /entservice/cmd/potassiumalarm

Method: POST

Params/json:

{
    "device_id":"866655060067405",
    "open":true,
    "blood_potassium_low":3.5,
    "blood_potassium_high":6.5
}

open - true 打开血钾报警, false 关闭血钾报警

blood_potassium_low - 低于这个值报警

blood_potassium_high - 高于这个值报警

自动房颤设置

URL: /entservice/cmd/autoaf

Method: POST

Params/json:

{
    "device_id":"984612114945605",
    "open":true,
    "interval":30,
    "rri_single_time":false
}

open - true 打开自动房颤, false 关闭自动房颤

interval - 自动房颤测量持续时间，单位秒，最小取值30，最大取值120，设置超出范围则按60生效

rri_single_time - 可选值。设置为true，按照心率间隔，每次测量完心率后测量一次。设置为false，一直测量

设置闹钟

URL: /entservice2/clockalarm/set

Method: POST

Params/json:

{
    "device_id":"869595060004461",
    "alarms":[
        {
            "repeat":true,
            "monday":true,
            "tuesday":true,
            "wednesday":true,
            "thursday":true,
            "friday":true,
            "saturday":true,
            "sunday":true,
            "hour":10,
            "minute":30,
            "title":"hehe"
        }
    ]
}

最多设置5个闹钟

repeat - true 重复, false 一次性

monday ~ sunday 对应的那天是否打开

hour/minute: 时间小时:分钟, 24小时

title: 闹钟内容

清除闹钟

URL: /entservice2/clockalarm/clear

Method: POST

Params/json:

{
    "device_id":"869595060004461"
}

设置久坐

URL: /entservice3/sedentary/set

Method: POST

Params/json:

{
    "device_id":"869595060004461",
    "sedentaries":[
        {
            "repeat":true,
            "monday":true,
            "tuesday":true,
            "wednesday":true,
            "thursday":true,
            "friday":true,
            "saturday":true,
            "sunday":true,
            "start_hour":0,
            "end_hour":23,
            "duration":5,
            "threshold":10
        }
    ]
}

最多设置3个久坐提醒

repeat - true 重复, false 一次性

monday ~ sunday 对应的那天是否打开

start_hour/end_hour: 久坐检查时间段，开始/结束小时 24小时

duration: 设置累计久坐分钟数达到多少分钟提醒, 单位为5分钟，即设置1，等于5分钟

threshold: 一分钟内步数少于多少，判断这一分钟为久坐，计数+1，单位步，默认40

duration/threshold: 只针对新设备新版本有效

清除久坐

URL: /entservice3/sedentary/clear

Method: POST

Params/json:

{
    "device_id":"869595060004461"
}

目标设置

URL: /entservice/cmd/goal

Method: POST

Params/json:

{
    "device_id":"984612114945605",
    "step":10000,
    "distance":10000,
    "calorie":400
}

step - 目标步数

distance - 目标距离,单位米

calorie - 目标卡路里,单位千卡

设备恢复出厂

URL: /entservice/cmd/factory/reset

Method: POST

Params/json:

{
    "device_id":"984612114945605"
}

设置语言

URL: /entservice/cmd/language/set

Method: POST

Params/json:

{
    "device_id":"984612114945605",
    "language":0
}

language:

0 English
1 Chinese
2 Italian
3 Japanese
4 France
5 German
6 Portuguese
7 Spanish
8 Russian
9 Korean
10 Arabic
11 Vietnam
12 Polish
13 Romanian
14 Swedish
15 Thai
16 Turkish
17 Denish
18 Ukrainian
19 Norwegian
20 Dutch
21 Czech
22 Chinese_Tc
23 Indonesian

发送设备消息

URL: /entservice/cmd/message

Method: POST

Params/json:

{
    "device_id":"866655060067405",
    "title":"好消息",
    "description":"中奖了，500万"
}

title最多15个字节, description最多240个字节

设置跌倒检测灵敏度

URL: /entservice/cmd/fallcheck/sensitivity

Method: POST

Params/json:

{
    "device_id":"866655060067405",
    "fall_threshold":20000
}

fall_threshold: 跌倒检测的灵敏度，默认14000

逆地理编码

URL: /entservice/location/geocode/regeo

Method: POST

Params/json:

{
    "lon":113.88959503173828,
    "lat":22.501605987548828,
    "account":"",
    "password":""
}

lon/lat params receive coordination system in GCJ-02

此接口根据不同账号有相应限制，具体情况请联系相关人士确定

心率数据测量间隔设置

URL: /entservice/cmd/measure/interval/hr

Method: POST

Params/json:

{
    "device_id":"984612114945605",
    "interval":10
}

interval - unit is minute, minimum 1 minute

其他非心率数据测量间隔设置

URL: /entservice/cmd/measure/interval/other

Method: POST

Params/json:

{
    "device_id":"984612114945605",
    "interval":10
}

非心率健康类功能,包括血氧、压力值、血压等。 interval - 间隔时间, 单位分钟，最小5分钟

Gps定位

URL: /entservice/cmd/gps/locate

Method: POST

Params/json:

{
    "device_id":"866655060067405",
    "gps_auto_check":true,
    "gps_interval_time":10,
    "run_gps":true
}

手表设置是否每次都进行GPS定位

gps_auto_check - 定位开关

gps_interval_time - 定位间隔，unit is minute

run_gps - 是否每次都进行GPS定位

设置时间格式(12/24小时)

URL: /entservice/cmd/timeformat

Method: POST

Params/json:

{
    "device_id":"866655060067405",
    "hour_format":1
}

手表设置时间显示24小时还是12小时

hour_format - 0 24小时，1 12小时

设置日期格式

URL: /entservice/cmd/dateformat

Method: POST

Params/json:

{
    "device_id":"866655060067405",
    "date_format":1
}

手表设置日期显示月/日还是日/月

date_format - 0 月/日，1 日/月

设置距离单位

URL: /entservice/cmd/distanceunit

Method: POST

Params/json:

{
    "device_id":"866655060067405",
    "distance_unit":1
}

手表设置距离单位公制还是英制

distance_unit - 0 公制，1 英制

设置温度单位

URL: /entservice/cmd/temperatureunit

Method: POST

Params/json:

{
    "device_id":"866655060067405",
    "temperature_unit":1
}

手表设置温度单位摄氏度还是华氏度

temperature_unit - 0 摄氏度，1 华氏度

api鉴权

如果向我们申请了API鉴权，调用API给属于您的手表发指令会检查账号信息，与设备所属客户的账号一致，才能给手表下发指令，否则返回:

{
        "ReturnCode": 10403
}

鉴权方法是在Http Header里面添加account和pwd字段，account填入账号，pwd填入密码的md5加密值