token（令牌）获取

更新时间：2024-02-23 17:22:24

接口地址

GET https://openapi.xu5g.com/tsp/auth/token

业务描述

接入方从兔盯云平台获得 appid 和 secret 进行认证服务校验，成功则返回鉴权标识 token。该接口用于接入方获取 token，接入方和兔盯云开放平台同时缓存该 token，token 过期则平台返回错误码，接入方重新调用 token 获取接口获取 token，token 过期时间为30天。平台业务接口需要对token校验，校验通过则完成身份验证。

请求参数

参数	是否必须	默认值	含义
transid	是		事务序号（由appkey、年月日时分秒、任意随机一个字符串12位组成）
appkey	是		平台分配的appkey
sign	是		签名

事务序号

transid = appkey+年月日时分秒(无特殊字符)+12位任意字符串
如：
transid = 10023420210312155026fab3fea33a56

签名算法

sign = sha1(secret+appkey+transid+secret)

返回结果参数说明

参数	含义
status	状态码
message	返回提示信息
expired	过期时间
token	令牌

返回示例

{
    "status": 0,
    "message": "操作成功",
    "data": {
        "expired": "2024-02-21 15:09:35",
        "token": "token"
    }
}

HTTP Headers

更新时间：2024-02-23 17:22:28

http header	含义
transid	事务序号（由appkey、年月日时分秒、任意随机一个字符串12位组成）。每次调用接口都需要生成一个新的transid
token	通过获取TOKEN接口获取到的身份标识

平台介绍

更新时间：2024-02-26 14:52:21

一、兔盯云是什么

一分钟让企业拥有智能硬件接入和应用的能力

提供以智能手表、手环、考勤机、蓝牙网关等成熟的智能硬件，同时对应提供完善、稳定的硬件API接入及被动消息推送能力。供需要智能硬件来完善产品板块的企业可以快速接入，减少寻找硬件、测试硬件、调试对接、搭建硬件平台等海量时间和资金成本，极速创建或融合基于智能硬件业务场景的应用。

通过接入兔盯云开放平台，我们将从安全、健康、考勤等基于智能硬件基础能力、完善成熟的API调用能力、支撑大规模应用和高级功能开发的被动消息推送能力、百亿数据存储等多个维度赋能您的应用，帮助您获得更多的流量、用户和收益，共建开放共赢新生态。

二、平台提供的服务

丰富的智能硬件：提供成熟的智能手表、手环、考勤设备。根据具体型号可以提供定位、通话、电子围栏、心率检测、体温检测、计步、血压检测等，智能硬件无需您来处理复杂的交互，使用我们平台的API即可快速实现控制设备。
数据加工能力 ：我平台已在底层屏蔽和统一了各种硬件协议差异，以及对硬件的脏数据进行了清洗和加工，对定位数据做了智能纠偏、同时提供溺水预警等数据加工能力，使之API调用的数据均为易读、易懂、易用。

三、核心系统说明

管理中心 ：具备开发能力的接入商入驻开放平台后，需要通过创建应用的方式接入兔盯云开放平台，选择适合自己的硬件，并对接API。基于应用的形式服务用户，创造价值。
内容运营 ：可以对自己的智能硬件做管理，同时提供完善的智能硬件表现服务（硬件定位状态、硬件定位、围栏、计步、血压、心率、体温等数据的浏览和统计）
对接服务 ：可以查阅详细的API文档，以及智能硬件主动触发的事件被动推送服务文档。接入商可以利用API主动请求，和事件被动推送，打造出功能丰富的应用。

坐标系

更新时间：2024-02-26 10:59:25

GCJ-02

获取设备详情

更新时间：2024-02-22 15:57:12

接口地址

GET https://openapi.xu5g.com/tsp/device/get

业务描述

根据设备号、考勤号查询设备详情

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

设备号与考勤号必须传值一个

参数	是否必须	默认值	参数类型	含义
imei_sn	否		string	设备IMEI号，长度为1-20
attence_sn	否		string	设备2.4G考勤号，长度为1-10

返回结果参数说明

参数	含义
active_time	设备激活时间
appkey	设备所属应用（appkey）
attence_sn	2.4G考勤号
blood_upload	血压上报时间
created	设备入库时间
dnd	免打扰时间段
engine	引擎名称
families	亲情号码
firstlink_time	首次连接时间
heart_upload	心率上报间隔
iccard_sn	13.56考勤号
iccid	SIM卡的iccid
imei_sn	设备号
is_online	是否在线 1：在线 0：离线
lat	经度
lng	纬度
locate_address	位置信息
locate_direction
locate_mode	定位模式 1：省电模式，2：智能模式，3：性能模式
locate_time	定位时间
locate_type	1:GPS 2:BTS(基站) 3:WIFI 4:未知
locate_upload	定位上报间隔
mobile	设备手机号
model_id
partner_id
power_rate
power_status
remind	闹钟
runstatus	1：运动中 2：静止
sleeptime	睡眠时间段
sos	SOS号码
status
temperature_upload	体温上报间隔
truename	设备名称
udtime	定位时间段
uuid	绑定设备时生成的UUID

返回示例

{
    "data": {
        "active_time": "",
        "appkey": 10028,
        "attence_sn": "",
        "blood_upload": 0,
        "created": "2024-01-25 17:53:54",
        "dnd": [
            {
                "dates": "12",
                "end": "07:00",
                "start": "01:05"
            },
            {
                "dates": "67",
                "end": "13:00",
                "start": "12:00"
            }
        ],
        "engine": "jx",
        "families": [],
        "firstlink_time": "",
        "gsm_rate": 0,
        "heart_upload": 0,
        "iccard_sn": "",
        "iccid": "",
        "imei_sn": "960304948761382",
        "is_online": 0,
        "lat": 0,
        "lng": 0,
        "locate_address": "",
        "locate_direction": 0,
        "locate_mode": 2,
        "locate_time": "",
        "locate_type": 0,
        "locate_upload": 600,
        "mobile": "",
        "model_id": 70,
        "partner_id": 10036,
        "power_rate": 0,
        "power_status": 2,
        "remind": [],
        "runstatus": 0,
        "sleeptime": {
            "end": "",
            "start": ""
        },
        "sos": [],
        "status": 0,
        "temperature_upload": 0,
        "truename": "",
        "udtime": {
            "end": "",
            "start": ""
        },
        "uuid": ""
    },
    "message": "操作成功",
    "status": 0
}

获取设备列表

更新时间：2024-02-22 15:54:58

接口地址

GET https://openapi.xu5g.com/tsp/devices/get

业务描述

根据各种筛选条件，查询出设备列表

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	否		string，长度为1-20	设备IMEI号
page	是		int，页码最小为1，最大为5000	页码
limit	是		int，每页最小为1，最大为200	每页显示几条
uuid	否		string	设备UUID
mobile	否		string，长度为11	手机号
attence_sn	否		string，长度为1-10	2.4G无感考勤号
is_online	否		string	是否在线
appkey	否		int	产品ID
partner_id	否		int	企业id
model_id	否		int	设备型号ID

返回结果参数说明

参数	含义
imei_sn	设备号
active_time	设备激活时间
attence_sn	2.4G无感考勤号
blood_upload	血压上报间隔
families	亲情号
sos	sos号码
iccard_sn	13.56有感考勤号
is_online	是否在线
product_id	产品ID
upload	定位上报间隔
model_id	设备型号ID
temp_upload	体温上报间隔
locate_type	1:GPS 2:BTS(基站) 3:WIFI 4:未知
locate_time	定位时间
locate_mode	定位模式：1：省电模式，2：智能模式，3：性能模式
locate_address	位置信息
power_rate	剩余电量
truename	终端名称
lng	经度
lat	纬度
udtime	定位时间段
runstatus	1：运动中 2：静止

返回示例

{
    "data": {
        "result": [
            {
                "appkey": 10028,
                "attence_sn": "",
                "created": "2024-01-25 17:53:54",
                "dnd": "[{\"start\":\"01:05\",\"end\":\"07:00\",\"dates\":\"12\"},{\"start\":\"12:00\",\"end\":\"13:00\",\"dates\":\"67\"}]",
                "engine": "jx",
                "families": "[]",
                "firstlink_time": "2024-01-25 17:34:25",
                "iccard_sn": "",
                "imei_sn": "960304948761382",
                "is_online": 0,
                "locate_mode": 2,
                "locate_upload": 600,
                "model_id": 70,
                "partner_id": 10036,
                "power_status": 2,
                "remind": "[]",
                "sos": "[]",
                "udtime": "{\"end\":\"\",\"start\":\"\"}"
            },
            {
                "active_time": "2024-02-20 13:47:11",
                "appkey": 10028,
                "attence_sn": "",
                "blood_upload": 0,
                "created": "2023-12-19 15:18:42",
                "dnd": "[]",
                "engine": "jx",
                "families": "[]",
                "firstlink_time": "2023-12-19 15:19:22",
                "gsm_rate": 0,
                "heart_upload": 0,
                "iccard_sn": "",
                "imei_sn": "689466010044171",
                "is_online": 1,
                "lat": "34.753164",
                "lng": "113.691883",
                "locate_address": "河南省郑州市管城回族区城东路街道城东路103号正商向阳广场",
                "locate_direction": 0,
                "locate_mode": 2,
                "locate_time": "2024-02-20 13:37:26",
                "locate_type": 3,
                "locate_upload": 360,
                "mobile": "",
                "model_id": 54,
                "partner_id": 10036,
                "power_rate": 74,
                "power_status": 2,
                "runstatus": 2,
                "sos": "[]",
                "temperature_upload": 0,
                "truename": "",
                "udtime": "{\"end\":\"22:00\",\"start\":\"06:00\"}",
                "uuid": ""
            }
        ],
        "total": 2
    },
    "message": "操作成功",
    "status": 0
}

更新设备详情

更新时间：2024-02-20 15:23:33

接口地址

PUT https://openapi.xu5g.com/tsp/device/update

业务描述

更新设备信息

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号
model_id	否		int	设备型号ID
truename	否		string	设备名称
mobile	否		string	设备手机号
attence_sn	否		string	2.4G考勤号
iccard_sn	否		string	13.56考勤号

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

下发定位指令

更新时间：2024-02-20 15:49:25

接口地址

GET https://openapi.xu5g.com/tsp/device/locate

业务描述

请求设备立即进行定位，定位成功后相关数据会更新到设备详情内，可通过获取设备详情接口进行查看当前位置

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

下发寻找设备指令

更新时间：2024-02-20 15:52:56

接口地址

GET https://openapi.xu5g.com/tsp/device/find

业务描述

下发后设备会发出声音，方便找寻设备

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

设置设备定位上报间隔

更新时间：2024-02-20 15:58:07

接口地址

PUT https://openapi.xu5g.com/tsp/device/locate/upload

业务描述

下发后设备会按照设置的这个间隔进行上报位置信息

例如：参数second：300 那么设备会每300秒更新一次位置信息到设备详情中

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号，长度为1-20
second	是		string	定位上报间隔，单位：秒

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

设置定位时间段

更新时间：2024-02-20 16:05:34

接口地址

PUT https://openapi.xu5g.com/tsp/device/udtime

业务描述

下发后设备只会在此时间段内按照定位上报间隔进行上报位置信息例如：参数 start：06:00 end：22:00 那么设备只会在早晨6点至晚上10点按照定位上报间隔进行上报位置，相反，这个时间段外则不会上报位置信息。可一定程度的节省设备电量

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号
start	是		string	开始时间，例如：06:00
end	是		string	结束时间，例如：22:00

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

设置亲情号码与SOS

更新时间：2024-02-20 16:07:10

接口地址

PUT https://openapi.xu5g.com/tsp/device/family

业务描述

写入手机号到设备中，写入成功后手机可与设备拨打电话或设备与手机拨打电话

注：本次设置会覆盖上一次设置的内容

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号
families	是		arrayObject	亲情号号码信息, 例如：[{"relation":"爸爸","mobile":"手机号"},{"relation":"妈妈","mobile":"手机号"}]
status	否	0	int	0：设置亲情号与sos 1：设置亲情号 2：设置sos

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

下发设置定位模式指令

更新时间：2024-02-20 16:22:12

接口地址

PUT https://openapi.xu5g.com/tsp/device/locate/mode

业务描述

不同的定位模式，待机情况不同、数据上报间隔不同、默认采用的定位方式不同

若是不采用内置的位置上报间隔，也可以通过locate_upload参数进行自定义位置上报间隔

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号
locate_mode	是		string	1：省电模式 2：智能模式 3：性能模式 4：自定义模式
locate_upload	否		int	定位上报间隔（秒），最小值60，最大值7200。当locate_mode使用4（自定义模式）时，才使用此locate_upload参数

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

下发设置免打扰指令

更新时间：2024-02-20 16:30:34

接口地址

PUT https://openapi.xu5g.com/tsp/device/dnd

业务描述

免打扰=静音/设备不可被呼入

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数

是否必须

默认值

参数类型

含义

imei_sn

是

string

设备号

dnd

是

string

免打扰时间段指令,

实例 8:00-11:30|123456;14:00-17:30|12345

12345表示周一到周五生效，1234567表示每天都生效。

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

下发关机指令

更新时间：2024-02-20 16:32:14

接口地址

GET https://openapi.xu5g.com/tsp/device/poweroff

业务描述

下发指令到设备，可使设备关机

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

下发重启指令

更新时间：2024-02-20 16:34:18

接口地址

GET https://openapi.xu5g.com/tsp/device/restart

业务描述

下发指令到设备，可使设备立即进行重启

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

下发聆听指令

更新时间：2024-02-20 16:36:12

接口地址

GET https://openapi.xu5g.com/tsp/device/monitor

业务描述

下发指令到设备，可使设备在拥有人不知情的情况下拨打指定的手机号

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
mobile	是		string	手机号
imei_sn	是		string	设备号

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

查看设备是否在线

更新时间：2024-02-20 16:39:46

接口地址

GET https://openapi.xu5g.com/tsp/device/online

业务描述

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号

返回结果参数说明

参数	含义
status	状态码
message	返回提示信息
is_online	0：离线 1：在线

返回示例

{
    "status": 0,
    "message": "操作成功",
    "data": {
        "is_online": 1
    }
}

绑定用户

更新时间：2024-02-20 16:55:08

接口地址

PUT https://openapi.xu5g.com/tsp/device/bind

业务描述

绑定设备到用户名下，将用户与设备关联起来

默认项

白名单为开启状态

定位模式为“智能模式”

定位时间段默认设置为06:00~22:00

心率、血压、体温，上报间隔进行关闭

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号
truename	是		string	设备名称
mobile	是		string	设备内SIM卡的手机号
uuid	是		string	根据业务情况自行拼接唯一的UUID UUID= 设备号+业务层用户ID UUID= 设备号

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

解除绑定用户

更新时间：2024-02-20 16:56:17

接口地址

PUT https://openapi.xu5g.com/tsp/device/unbind

业务描述

解除用户与设备之间的关联

同时会清空亲情号码、sos号码、恢复上报间隔

解绑设备后会默认设置通话白名单为开启状态、默认设置定位模式为“智能模式”

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

下发微聊音频到设备的指令

更新时间：2024-02-21 09:16:15

接口地址

PUT https://openapi.xu5g.com/tsp/device/wchat

业务描述

传输微聊音频文件到设备, 设备播放此音频

目前仅支持amr格式的音频文件,语音时长建议在20秒以内

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号
wchat_audio_url	是		string	amr音频文件的地址

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

变更设备通话白名单状态

更新时间：2024-02-20 17:03:50

接口地址

PUT https://openapi.xu5g.com/tsp/device/whitelist/status

业务描述

1：开启通话白名单，只有亲情号码才可来电 2：关闭通话白名单，即不阻止陌生来电

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号
whitelist_status	是	0	int	1：开启通话白名单，只有亲情号码才可来电2：关闭通话白名单，即不阻止陌生来电

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

设置设备闹钟

更新时间：2024-03-28 16:31:46

接口地址

PUT https://openapi.xu5g.com/tsp/device/remind

业务描述

参考手机闹钟功能

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数

是否必须

默认值

参数类型

含义

imei_sn

是

string

设备号

remind

是

arrayObject

示例[{"date":"08:00","status":1,"remind_type":"2","week":"0111110","title

":"起床闹钟"}]

date：闹钟时间，例如 08:00 也就是早晨8点的闹钟

status：闹钟状态：1为开启，0为关闭

remind_type：闹钟类型：1为一次性闹钟，2为每天，3为自定义

week：闹钟日期，当类型为自定义时，需要配置自定义的日期，用7位数字表示从周日开始的7天，1或0表示当前是否响铃，如0111110表示周一到周五响铃；类型为1时 week=0000000 类型为2时 week=1111111

title：闹钟标题

注：此接口为覆盖式的操作，本次设置的闹钟会覆盖上次的设置

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

发送文字消息到设备

更新时间：2024-02-20 17:07:06

接口地址

POST https://openapi.xu5g.com/tsp/device/wordsmessage

业务描述

发送文字消息到设备，设备显示屏会展示发送过来的文字

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号
message	是		string	文字消息，长度不可超过50

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

限制关机及定时开关机

更新时间：2024-02-20 17:08:16

接口地址

PUT https://openapi.xu5g.com/tsp/device/cronshutdwn

业务描述

可限制设备不允许按键关机以及设置设备的定时开机定时关机

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号
is_handshutdown	是		int	1代表为不允许按键关机，0代表为允许按键关机
is_cronshutdown	是		int	1代表为开启定时开关机，0代表为关闭定时开关机，开启后定时开关机后poweron_time与shutdown_time参数为必填项
poweron_time	否		string	开机时间

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

获取轨迹

更新时间：2024-02-23 15:11:41

接口地址

GET https://openapi.xu5g.com/tsp/tracks/get

业务描述

根据设备号、时间范围查询设备轨迹数据

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	传参类型	含义
imei_sn	否		string	设备IMEI号，长度不超过20
uuid	否		string	设备uuid，长度不超过40
sort	否		string	数据排序方式，值为asc或desc
start_time	是		string	开始时间，格式为2006-01-01 00:00:00
end_time	是		string	结束时间，格式为2006-01-01 00:00:00
page	是		int	页码，范围为1-5000
limit	是		int	每页条数，范围为1-200

返回结果参数说明

参数	含义
address	定位地址
city_id
direction
district_id
imei_sn	设备号
lat	纬度
lng	经度
locate_time	定位数据上报时间
locate_type	GPS=1；基站类型=2；wifi类型=3
province_id
radius
speed
uuid	UUID

返回示例

{
    "data": {
        "result": [
            {
                "address": "河南省郑州市管城回族区城东路街道河南黄河水文勘测设计院正商向阳广场",
                "city_id": 0,
                "direction": 0,
                "district_id": 0,
                "imei_sn": "689466010044171",
                "lat": "34.753154",
                "lng": "113.691905",
                "locate_time": "2024-02-23 08:59:06",
                "locate_type": 3,
                "province_id": 0,
                "radius": 8,
                "speed": 0,
                "uuid": ""
            }
        ],
        "total": 1
    },
    "message": "操作成功",
    "status": 0
}

设置心率数据上报时间间隔

更新时间：2024-02-22 13:44:23

接口地址

PUT https://openapi.xu5g.com/tsp/heart/upload/set

业务描述

根据设备号设置心率数据上报时间间隔

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数

是否必须

默认值

参数类型

含义

imei_sn

是

string

设备IMEI号，长度不超过20

second

是

int

数据上报时间间隔，最小60，最大65535，单位：秒；若设置上报间隔则60秒起步

0：终端心率上传关闭；

1：终端立即开启单次心率上传，上传完后自动关闭

返回示例


{
    "status": 0,
    "message": "操作成功",
    "data": null
}

获取心率数据上报时间间隔

更新时间：2024-02-22 13:44:28

接口地址

GET https://openapi.xu5g.com/tsp/heart/upload/get

业务描述

根据设备号获取心率数据上报的时间间隔

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备IMEI号，长度不超过20

返回结果参数说明

参数	含义
heart_upload	心率数据上报时间间隔，单位：秒

返回示例

{
    "status": 0,
    "message": "操作成功",
    "data": {
      "heart_upload":300
    }
}

获取设备最近一次的心率

更新时间：2024-02-22 13:44:32

接口地址

GET https://openapi.xu5g.com/tsp/heart/get

业务描述

根据设备号或者uuid获取最近一次测量的心率数据

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备IMEI号，长度不超过20
uuid	否		string	设备uuid，长度不超过40

返回结果参数说明

参数	含义
created	数据创建时间
imei_sn	设备号
uuid	UUID
heart_rate	心率值

请求实例

{
    "status": 0,
    "message": "操作成功",
    "data": {
        "imei_sn": "863659040942004",
        "uuid": "1000-0-1043-863659040942004",
        "heart_rate": 76,
        "created": "2021-03-24 17:39:11"
    }
}

获取心率数据

更新时间：2024-02-22 13:44:37

接口地址

GET https://openapi.xu5g.com/tsp/hearts/get

业务描述

根据设备号、时间范围查询设备心率数据列表

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	否		string	设备IMEI号，长度不超过20
uuid	否		string	设备uuid，长度不超过40
sort	否		string	数据排序方式，值为asc或desc
start_time	是		string	开始时间，格式为2006-01-01 00:00:00
end_time	是		string	结束时间，格式为2006-01-01 00:00:00
page	是		int	页码，范围为1-5000
limit	是		int	每页条数，范围为1-200

返回参数

参数	含义
create_time	数据创建时间
imei_sn	设备号
uuid	UUID
heart_rate	心率值

返回示例

{
  "status": 0,
  "message": "操作成功",
  "data": {
    "result": [
      {
        "created": "2021-03-23 23:58:51",
        "heart_rate": 91,
        "imei_sn": "863659040942004",
        "uuid": "1000-0-1043-863659040942004"
      }],
    "total": 1
  }
}

获取最近一次的血压

更新时间：2024-02-22 13:44:44

接口地址

GET https://openapi.xu5g.com/tsp/blood/get

业务描述

根据设备号或者uuid获取最近一次测量的血压数据

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备IMEI号，长度不超过20
uuid	否		string	设备uuid，长度不超过40

返回结果参数说明

参数	含义
created	数据创建时间
imei_sn	设备号
uuid	UUID
blood_rate	血压值
max_rete	高血压
min_rate	低血压

返回示例

{
    "status": 0,
    "message": "操作成功",
    "data": {
        "imei_sn": "863659040942004",
        "uuid": "1000-0-1043-863659040942004",
        "blood_rate": "75-114",
        "max_rate": 0,
        "min_rate": 0,
        "created": "2021-03-24 17:29:11"
    }
}

获取血压数据

更新时间：2024-02-22 13:44:50

接口地址

GET https://openapi.xu5g.com/tsp/bloods/get

业务描述

根据设备号、时间范围查询设备血压数据列表

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	否		string	设备IMEI号，长度不超过20
uuid	否		string	设备uuid，长度不超过40
sort	否		string	数据排序方式，值为asc或desc
start_time	是		string	开始时间，格式为2006-01-01 00:00:00
end_time	是		string	结束时间，格式为2006-01-01 00:00:00
page	是		int	页码，范围为1-5000
limit	是		int	每页条数，范围为1-200

返回结果参数说明

参数	含义
create_time	数据创建时间
imei_sn	设备号
uuid	UUID
blood_rate	血压值

返回示例

{
    "status": 0,
    "message": "操作成功",
    "data": {
        "result": [
            {
                "blood_rate": "74-113",
                "created": "2021-03-12 23:59:10",
                "imei_sn": "863659040942004",
                "uuid": "1000-0-1043-863659040942004"
            }
        ],
        "total": 1
    }
}

设置血压数据上报时间间隔

更新时间：2024-02-22 13:44:55

接口地址

PUT https://openapi.xu5g.com/tsp/blood/upload/set

业务描述

根据设备号设置血压数据上报时间间隔

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数

是否必须

默认值

参数类型

含义

imei_sn

是

string

设备IMEI号，长度不超过20

second

是

int

数据上报时间间隔，最小60，最大65535，单位：秒；若设置上报间隔则60秒起步

0：终端血压上传关闭；

1：终端立即开启单次血压上传，上传完后自动关闭

返回示例

{
    "status": 0,
    "message": "操作成功",
    "data": null
}

获取血压数据上报时间间隔

更新时间：2024-02-22 13:44:59

接口地址

GET https://openapi.xu5g.com/tsp/blood/upload/get

业务描述

根据设备号获取血压数据上报的时间间隔

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备IMEI号，长度不超过20

返回结果参数说明

参数	含义
blood_upload	血压数据上报时间间隔，单位：秒

请求实例

{
    "status": 0,
    "message": "操作成功",
    "data": {
      "blood_upload":300
    }
}

获取计步数据

更新时间：2024-02-22 13:48:14

接口地址

GET https://openapi.xu5g.com/tsp/steps/get

业务描述

根据设备号、时间范围查询设备计步数据

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	否		string	设备IMEI号，长度不超过20
uuid	否		string	设备uuid，长度不超过40
sort	否		string	数据排序方式，值为asc或desc
start_time	是		string	开始时间，格式为2006-01-01 00:00:00
end_time	是		string	结束时间，格式为2006-01-01 00:00:00
page	是		int	页码，范围为1-5000
limit	是		int	每页条数，范围为1-200

返回结果参数说明

参数	含义
create_time	数据创建时间
imei_sn	设备号
uuid	UUID
step_rate	步数
day	日期

返回示例

{
    "status": 0,
    "message": "操作成功",
    "data": {
        "result": [
            {
                "created": "2021-03-23 22:09:03",
                "day": "2021-03-23",
                "imei_sn": "863659040942004",
                "step_rate": 3001,
                "uuid": "1000-0-1043-863659040942004"
            }
        ],
        "total": 1
    }
}

获取睡眠数据

更新时间：2024-02-22 13:55:14

接口地址

GET https://openapi.xu5g.com/tsp/sleeps/get

业务描述

根据设备号、时间范围查询设备睡眠数据列表

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	否		string	设备IMEI号，长度不超过20
uuid	否		string	设备uuid，长度不超过40
sort	否		string	数据排序方式，值为asc或desc
start_time	是		string	开始时间，格式为2006-01-01 00:00:00
end_time	是		string	结束时间，格式为2006-01-01 00:00:00
page	是		int	页码，范围为1-5000
limit	是		int	每页条数，范围为1-200

返回结果参数说明

参数	含义
created	数据创建时间
imei_sn	设备号
uuid	UUID
start_time	睡眠起始时间
end_time	睡眠结束时间
sleep_type	睡眠类型，1：深睡；2：浅睡；3：醒来 4：sleep_time = 深睡-浅睡
sleep_time	睡眠时长，单位：分钟

返回示例

{
    "status": 0,
    "message": "操作成功",
    "data": {
        "result": [
            {
                "created": "2021-03-12 22:33:11",
                "end_time": "2021-03-12 22:33:04",
                "imei_sn": "863659040942004",
                "sleep_time": 10,
                "sleep_type": 1,
                "start_time": "2021-03-12 22:23:04",
                "uuid": "1000-0-1043-863659040942004"
            }
        ],
        "total": 1
    }
}

获取最近一次的睡眠

更新时间：2024-02-22 13:56:15

接口地址

GET https://openapi.xu5g.com/tsp/sleep/get

业务描述

根据设备号或者uuid获取最近一次测量的睡眠数据

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备IMEI号，长度不超过20
uuid	否		string	设备uuid，长度不超过40

返回结果参数说明

参数	含义
created	数据创建时间
imei_sn	设备号
uuid	UUID
sleep_time	睡眠时间，单位：分钟
sleep_type	睡眠类型 1：深度睡眠，2：浅睡眠，3：醒来时长
start_time	睡眠起始时间
end_time	睡眠结束时间

返回示例

{
    "status": 0,
    "message": "操作成功",
    "data": {
        "imei_sn": "863659041446690",
        "uuid": "5000-0-30-863659041446690",
        "sleep_time": 10,
        "sleep_type": 1,
        "start_time": "2021-04-23 21:52:47",
        "end_time": "2021-04-23 22:02:48",
        "created": "2021-04-23 22:02:54"
    }
}

设置睡眠时间段

更新时间：2024-02-22 13:57:03

接口地址

PUT https://openapi.xu5g.com/tsp/device/sleeptime

业务描述

下发后设备只会在此时间段内检测睡眠情况进行睡眠数据上报

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号
start	是		string	开始时间，例如：22:00
end	是		string	结束时间，例如：07:00

返回示例

{
    "status":0,
    "message":"操作成功",
}

获取最近一次的体温数据

更新时间：2024-02-22 14:02:42

接口地址

GET https://openapi.xu5g.com/tsp/temperature/get

业务描述

根据设备号或UUID查询设最新体温数据

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备IMEI号，长度不超过20
uuid	否		string	设备UUID，长度不超过40

备注：uuid和imei_sn不能同时为空

返回结果参数说明

参数	含义
created	测量时间
imei_sn	设备号
uuid	UUID
temperature	测量温度

返回示例

{
    "status": 0,
    "message": "操作成功",
    "data": {
        "imei_sn": "863659041629634",
        "uuid": "1000-0-4-863659041629634",
        "temperature": "36.1",
        "created": "2021-03-23 18:26:08"
    }
}

设置体温测量间隔时间

更新时间：2024-02-22 14:09:41

接口地址

PUT https://openapi.xu5g.com/tsp/temperature/upload/set

业务描述

根据设备号设置体温数据上报时间间隔

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数

是否必须

默认值

参数类型

含义

imei_sn

是

string

设备IMEI号，长度不超过20

second

是

int

数据上报时间间隔，最小300，最大65535，单位：秒；若设置上报间隔则300秒起步

0：终端体温上传关闭；

1：终端立即开启单次体温上传，上传完后自动关闭

返回结果参数说明

参数	含义
status	状态：0为正常；1为错误
message	错误信息

返回示例

{
    "status": 0,
    "message": "操作成功",
    "data": null
}

获取体温测量间隔时间

更新时间：2024-02-22 14:09:49

接口地址

GET https://openapi.xu5g.com/tsp/temperature/upload/get

业务描述

根据设备号查询体温上报时间间隔

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备IMEI号，长度不超过20

返回结果参数说明

参数	含义
temperature_upload	体温数据上报间隔时间单位：秒

返回示例

{
    "status": 0,
    "message": "操作成功",
    "data": {
      "temperature_upload":300
    }
}

获取体温测量结果列表

更新时间：2024-06-07 16:54:02

接口地址

GET https://openapi.xu5g.com/tsp/temperatures/get

业务描述

根据设备号、时间范围等参数查询测量体温数据列表

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	否		string	设备IMEI号，长度不超过20
uuid	否		string	设备UUID，长度不超过40
sort	否	desc	string	数据排序方式，值为asc或desc
start_time	是		string	开始时间，格式为2006-01-01 00:00:00
end_time	是		string	结束时间，格式为2006-01-01 00:00:00
page	是		int	页码，范围为1-5000
limit	是		int	每页条数，范围为1-100

返回结果参数说明

参数	含义
created	测量时间
imei_sn	设备号
uuid	UUID
temperature	测量温度

返回示例

{
    "status": 0,
    "message": "操作成功",
    "data": {
        "result": [
            {
                "created": "2021-03-23 11:41:00",
                "imei_sn": "863659041629634",
                "temperature": "36.7",
                "uuid": "1000-0-4-863659041629634"
            }
        ],
        "total": 1
    }
}

获取血氧数据

更新时间：2024-02-22 14:17:59

接口地址

GET https://openapi.xu5g.com/tsp/bloodoxygens/get

业务描述

根据设备号、时间范围查询设备血氧数据列表

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	否		string	设备IMEI号，长度不超过20
uuid	否		string	设备uuid，长度不超过40
sort	否		string	数据排序方式，值为asc或desc
start_time	是		string	开始时间，格式为2006-01-01 00:00:00
end_time	是		string	结束时间，格式为2006-01-01 00:00:00
page	是		int	页码，范围为1-5000
limit	是		int	每页条数，范围为1-200

返回结果参数说明

参数	含义
created	数据创建时间
imei_sn	设备号
uuid	UUID
blood_oxygen_rate	血氧值

返回示例

{
    "data": {
        "result": [
            {
                "blood_oxygen_rate": 98,
                "created": "2022-06-22 17:01:40",
                "imei_sn": "689466010007541",
                "uuid": ""
            },
            {
                "blood_oxygen_rate": 99,
                "created": "2022-06-22 15:07:31",
                "imei_sn": "689466010007541",
                "uuid": ""
            }
        ],
        "total": 2
    },
    "message": "操作成功",
    "status": 0
}

获取最近一次的血氧数据

更新时间：2024-02-22 14:18:51

接口地址

GET https://openapi.xu5g.com/tsp/bloodoxygen/get

业务描述

根据设备号或者uuid获取最近一次测量的血氧数据

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	传参类型	含义
imei_sn	是		string	设备IMEI号，长度不超过20
uuid	否		string	设备uuid，长度不超过40

返回结果参数说明

参数	含义
created	数据创建时间
imei_sn	设备号
uuid	UUID
blood_oxygen_rate	血氧值

返回示例

{
    "data": {
        "blood_oxygen_rate": "98",
        "created": "2022-06-22 17:01:40",
        "imei_sn": "689466010007541",
        "uuid": ""
    },
    "message": "操作成功",
    "status": 0
}

添加围栏

更新时间：2024-02-22 14:20:14

接口地址

POST https://openapi.xu5g.com/tsp/fence/create

业务描述

添加围栏

注：当添加围栏UUID为空时则代表添加的是应用围栏，反之则是设备围栏

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
uuid	否		string	设备UUID，长度不超过40
truename	是		string	围栏名称，长度不超过32
fence_type	是		int	围栏类型，1：应用围栏；2：设备围栏；目前仅支持设备围栏
shape_type	是		int	围栏形状，1：点状围栏；2：多边形围栏
collide_type	是		int	告警类型，1：进出告警；2：靠近告警；3：进出+靠近告警
points	是		arrayObject	坐标集例如：[{"lat":"xx","lng":"xx"},{"lat":"xx","lng":"xx"}]
near_radius（预留参数）	否	0	int64	靠近围栏预警半径（米）
point_radius（预留参数）	否	0	int64	点围栏预警半径（米）
valid_start	是		string	有效开始时间；格式H:i（08:00）
valid_end	是		string	有效结束时间；格式H:i（18:00）
valid_week	是		string	有效周天；周一至周日分别为1-7，逗号分割（1,2,3,4,5,6,7）

返回结果参数说明

参数	含义
data	围栏id

返回示例

{
    "status": 0,
    "message": "操作成功",
    "data": 2
}

获取围栏列表

更新时间：2024-02-22 14:22:01

接口地址

GET https://openapi.xu5g.com/tsp/fences/get

业务描述

根据应用ID、uuid等参数查询围栏列表

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
uuid	否		string	设备UUID，长度不超过40
fence_type	否		int	围栏类型，1：应用围栏；2：设备围栏；目前仅支持设备围栏
shape_type	否		int	围栏形状，1：点状围栏；2：多边形围栏
page	是		int	页码，范围为1-5000
limit	是		int	每页条数，范围为1-200

返回结果参数说明

参数	含义
appkey	应用id
collide_type	告警类型，1：进出告警；2：靠近告警；3：进出+靠近告警
create_at	围栏创建时间
fence_type	围栏类型，1：系统围栏；2：设备围栏
geo
id	围栏ID
near_radius	靠近围栏预警半径（米）
partner_id
point_radius	点状围栏预警半径
points	围栏坐标集
shape_type	围栏形状，1：点状围栏；2：多边形围栏
truename	围栏名称
uuid	UUID
valid_start	围栏生效起始时间
valid_end	围栏生效结束时间
valid_week	围栏生效周期，周一至周日
total	数据总条数

返回示例

{
    "data": {
        "result": [
            {
                "appkey": 10028,
                "collide_type": 1,
                "create_at": "2024-02-22 09:38:45",
                "fence_type": 2,
                "geo": "",
                "id": 67,
                "near_radius": 0,
                "partner_id": 10036,
                "point_radius": 0,
                "points": "[{\"lat\":34.759623,\"lng\":113.767918},{\"lat\":34.759623,\"lng\":113.767918},{\"lat\":34.759623,\"lng\":113.767918}]",
                "shape_type": 2,
                "truename": "围栏C",
                "uuid": "10009-0-1093-689466020118643",
                "valid_end": "18:00",
                "valid_start": "08:00",
                "valid_week": "1,2,3,4,5,6,7"
            }
        ],
        "total": 1
    },
    "message": "操作成功",
    "status": 0
}

删除围栏

更新时间：2024-02-22 14:20:38

接口地址

DELETT https://openapi.xu5g.com/tsp/fence/delete

业务描述

删除围栏

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
id	是		int	主键id

返回示例

{
    "status": 0,
    "message": "操作成功",
    "data": null
}

获取考勤数据列表

更新时间：2024-02-23 15:44:26

接口地址

GET https://openapi.xu5g.com/tsp/attences/get

业务描述

根据设备号、时间范围查询设备考勤数据

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	否		string	设备IMEI号，长度不超过20
uuid	否		string	设备uuid，长度不超过40
sort	否		string	数据排序方式，值为asc或desc
start_time	是		string	开始时间，格式为2006-01-01 00:00:00
end_time	是		string	结束时间，格式为2006-01-01 00:00:00
page	是		int	页码，范围为1-5000
limit	是		int	每页条数，范围为1-200

返回结果参数说明

参数	含义
created	数据创建时间
imei_sn	设备号
uuid	UUID
attence_sn	考勤号
gatebrake	考勤机编号
code	0-进校,上车； 1-离校,下车；2-进校（卡电量低）；3-离校（卡电量低）；4-单读头模式；5-单读头模式(电量低)；6-到达校门口；7-蓝牙网关考勤；

返回示例

{
    "status": 0,
    "message": "操作成功",
    "data": {
        "result": [
            {
                "attence_sn": "41439760",
                "code": 7,
                "created": "2021-03-31 23:59:55",
                "gatebrake": "246F28C7EB14",
                "imei_sn": "863659041439760",
                "uuid": ""
            }
        ],
        "total": 1
    }
}

蓝牙配对

更新时间：2024-08-06 23:05:03

接口地址

PUT https://openapi.xu5g.com/tsp/bluetooth/switch

业务描述

下发mac地址到设备

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	是		string	设备号
status	是		int	1：配对 0：取消配对
mac	是		string	蓝牙mac地址 EA:47:14:5A:A9:B2

返回示例

{
    "status":0,
    "message":"操作成功",
    "data":null
}

获取跳绳数据列表

更新时间：2024-08-06 23:08:10

接口地址

GET https://openapi.xu5g.com/tsp/temperatures/get

业务描述

根据设备号、时间范围等参数查询跳绳数据列表

请求头

该请求操作的实现使用了公共请求头。有关详细信息，请查阅文档内的HTTP Headers。

请求参数

参数	是否必须	默认值	参数类型	含义
imei_sn	否		string	设备IMEI号，长度不超过20
uuid	否		string	设备UUID，长度不超过40
sort	否	desc	string	数据排序方式，值为asc或desc
start_time	是		string	开始时间，格式为2006-01-01 00:00:00
end_time	是		string	结束时间，格式为2006-01-01 00:00:00
page	是		int	页码，范围为1-5000
limit	是		int	每页条数，范围为1-100

返回结果参数说明

参数	含义
per_skip_num	预置跳绳个数
actual_skip_num	实际跳绳个数
per_skip_time	预置跳绳时间，单位：秒
actual_skip_time	实际跳绳时间，单位：秒
calorie	消耗卡路里
actual_skip_created	实际跳绳的起跳时间

返回示例

{
    "data": {
        "result": [
            {
                "actual_skip_created": "2024-06-27 22:02:11",
                "actual_skip_num": 3,
                "actual_skip_time": 181,
                "appkey": 1000,
                "calorie": 225,
                "created": "2024-06-27 22:02:11",
                "imei_sn": "869057061100582",
                "per_skip_num": 0,
                "per_skip_time": 0,
                "uuid": "1-100-111111111"
            },
            {
                "actual_skip_created": "2024-06-07 15:59:03",
                "actual_skip_num": 5,
                "actual_skip_time": 9,
                "appkey": 1000,
                "calorie": 231,
                "created": "2024-06-07 16:04:30",
                "imei_sn": "869057061100582",
                "per_skip_num": 0,
                "per_skip_time": 0,
                "uuid": "1000-0-1047-869057061100582"
            }
        ],
        "total": 2
    },
    "message": "操作成功",
    "status": 0
}

EMP

更新时间：2024-06-18 17:34:37

因为硬件的特殊性和接入方的业务需求及便利性，平台还提供了硬件事件消息推送能力。针对硬件主动触发的事件，如：硬件进出围栏、硬件低电量、硬件轨迹上报、硬件上线、硬件测量体温、硬件考勤等。

由EMP系统主动推向接入方，接入方被动接收EMP消息。极大便利了接入方的业务灵活性和提高了开发效率。

注意

收到EMP推送的消息后请按照以下要求进行回复

HTTP POST
{
    "status":0,
    "message":"ok",
}

Rabbitmq
return true

睡眠

{
"data":{
"created":"数据上报时间",
"end_time":"睡眠结束时间",
"imei_sn":"设备号",
"sleep_time":"124-353",
"sleep_type":4,//1 深度睡眠，2 浅睡眠，3 醒来时长, 4:深睡与浅睡 = sleeptime = 深睡-浅睡
"start_time":"睡眠开始时间",
"uuid":"设备uuid"
},
"router":"device.sleep"
}

考勤

{
"data":{
"imei_sn":    "设备号",
"attence_sn": "2.4G考勤号",
"code":       "0-进校,上车； 1-离校,下车；2-进校（卡电量低）；3-离校（卡电量低）",
"gatebrake":  "考勤机的设备号",
"created":    "考勤时间",
"uuid":"设备uuid"
},
"router":"attence.create"
}

血压

{
"data":{
"imei_sn":    "设备号",
"blood_rate": "低压-高压",
"uuid":       "设备UUID",
"created":    "测量时间",
},
"router":"device.blood"
}

心率

{
"data":{
"imei_sn":    "设备号",
"heart_rate": "心率",
"created":    "测量时间",
"uuid":"设备uuid"
},
"router":"device.heart"
}

低电量告警

低电量告警规则

当设备电量低于20%时判定为低电量，告警一次

当设备电量低于10%时，判定为低电量，告警一次

当设备电量低于5%时，判定为低电量，告警一次

满三次告警，不再告警。

{
"data":{
"imei_sn":    "设备号",
"uuid":"设备uuid",
"power_rate": "电量",
"power_time":    "时间",
},
"router":"device.lowpower"
}

SOS

{
"data":{
"imei_sn":     "设备号",
"uuid":"设备uuid",
"lat":         "纬度",
"lng":         "经度",
"province_id": "省ID",
"city_id":     "市ID",
"discrict_id": "区/县ID",
"locate_type": "定位模式 1:GPS 2:BTS(基站) 3:WIFI 4:未知",
"locate_time": "定位时间",
"address":     "sos告警所在地",
"sos_time":    "sos告警时间",
},
"router":"device.sos"
}
//注:当产生sos告警时未获取到位置时则无相关位置信息
{
"data":{
"imei_sn":    "设备号",
"uuid":"设备uuid",
"sos_time":   "sos告警时间",
},
"router":"device.sos"
}

计步

{
"data":{
"imei_sn":   "设备号",
"step_rate": "步数",
"uuid":      "设备UUID",
"created":   "时间"
},
"router":"device.step"
}

体温

{
"data":{
"temperature": "体温",
"imei_sn":     "设备号",
"uuid":        "设备UUID",
"appkey":      "设备所属的APPKEY",
"created":     "测量时间",
},
"router":"device.temperature"
}

微聊

{
"data":{
"imei_sn":         "设备号",
"uuid":"设备uuid",
"wchat_audio_uri": "微聊音频文件url",
"duration":        "音频文件时长",
"created":         "发送时间",
},
"router":"device.wchat"
}

围栏

{
"data":{
"imei_sn":"设备号",
"uuid":"设备uuid",
"lat":"纬度",
"lng":"经度",
"locate_time": "最新一次的定位时间",
"locate_type": "定位模式 1:GPS 2:BTS(基站) 3:WIFI 4:未知",
"address": "所在地址",
"radius":"",
"direction":"in：进入围栏,out：离开围栏",
"fence_id":0,//围栏ID
"fence_truename":"围栏名称"
},
"router":"fence.warning"
}

当前有效轨迹（当前位置）

{
"data":{
"imei_sn":     "设备号",
"uuid":        "设备uuid",
"province_id": 0,
"city_id":     0,
"district_id": 0,
"lat":         "纬度",
"lng":         "经度",
"radius":      "",
"direction":   "地址",
"address":     "地址",
"speed":       "",
"locate_lrd":  ""
"locate_type": "定位模式 1:GPS 2:BTS(基站) 3:WIFI",
"locate_time": "定位时间"
},
"router":"track.create"
}

错误码

更新时间：2024-02-23 15:23:41

错误码	含义
0	正常
1	常规错误
11	重新获取Token

SDK

更新时间：2024-02-23 15:23:40

Go

https://github.com/xu5g/bluebird-sdk-go

PHP

https://github.com/xu5g/bluebird-sdk-php

更新日志

更新时间：2024-02-23 17:20:40

兔盯云API V3.1.0 上线 2021-08-24

调整了设置亲情号接口，增加了状态status 0：设置亲情号与sos 1：设置亲情号 2：设置sos
下发设置定位模式接口新增参数locate_upload；可以使用系统内已经定义好的三种定位模式，也可通过locate_uplote参数进行自定义

兔盯云API V3.1.2 上线 2021-08-27

新增修改设备通话白名单状态接口

兔盯云API V3.1.3 上线 2021-09-10

优化了设备功能清单

兔盯云API V3.1.4 上线 2021-09-14

新增批量设置定位模式接口

兔盯云API V3.1.5 上线 2022-01-06

新增设置设备闹钟的接口

兔盯云API V3.1.6 上线 2022-05-07

调整部分接口参数

兔盯云API V3.1.7 上线 2022-05-30

新增发送文字消息到设备的接口

兔盯云API V3.1.8 上线 2022-06-23

新增血氧数据查询接口

兔盯云API V3.1.9 上线 2022-07-22

设置定位模式接口新增自定义模式
优化设备重启指令刷新机制
解绑设备后清除之前无用的缓存指令

兔盯云API V3.2.0 上线 2023-07-18

增加设置设备限制关机及定时开关机接口