在线咨询
电话咨询
19537881268
微信咨询
返回顶部

兔盯云API

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

备注:uuidimei_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-02-22 14:09:23

接口地址

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

EMP

更新时间:2024-02-23 16:34:52

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

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


注意

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

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

更新日志

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

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

  1. 调整了设置亲情号接口,增加了状态status 0: 设置亲情号与sos 1:设置亲情号 2:设置sos

  2. 下发设置定位模式接口 新增参数locate_upload;可以使用系统内已经定义好的三种定位模式,也可通过locate_uplote参数进行自定义


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

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


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

  1. 优化了设备功能清单


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

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


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

  1. 新增设置设备闹钟的接口


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

  1. 调整部分接口参数


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

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


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

  1. 新增血氧数据查询接口


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

  1. 设置定位模式接口 新增自定义模式

  2. 优化设备重启指令刷新机制

  3. 解绑设备后清除之前无用的缓存指令


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

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