手表设置

# 云端对接方式调用的API

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

国内 Host: https://search.iwown.com

国外 Host: https://euapi.iwown.com

返回值格式:

{
    "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
}

Note:

  • 性别(gender):1 男,2 女;

  • 身高(height):单位厘米;

  • 体重(weight):单位公斤;

  • 年龄(age);

  • calibrate_walk、calibrate_run 请勿修改,默认100

设备实时定位

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加密值