文档
测试

获取设备数据

POST
GetDeviceRealtimeData

接口描述

获取设备数据

请求参数

参数名
类型
描述
必填
dataJson
object
数据参数 添加
必填
key
string
秘钥:29c0b6ed48d52c76122cc003fd79383c
必填
mac
string
设备MAC
必填
timestamp
int64
时间戳,0代表返回最后一条数据,大于0代表时间错
必填
waveform
bool
是否获取波形数据 true获取 false不获取
必填

响应参数

参数名
类型
描述
必填
ret
int
示例:0
必填
err_code
int
示例:0
必填
msg
string
示例:ok
必填
timestamp
int
最新时间截 示例:1751276747743
必填
mac
string
设备MAC 示例:f4:cf:a2:80:48:14
必填
data
array
数据列表
必填
date
string
数据时间 示例:2025-06-30 17:45:47
必填
id
int
数据ID 即时间截 示例:1751276747743
必填
temperature
int
室内温度 示例:0
必填
humidity
int
相对湿度 示例:0
必填
inbed
boolean
是否在床,true代表在床,false代表不在床 示例:true
必填
body_movement
boolean
是否体动,true代表有体动,false代表没有体动 示例:false
必填
left
object
左侧传感器 数据字典
必填
respiration_rate
float
呼吸率 示例:9.5
必填
heart_rate
int
心率 示例:57
必填
respiratory_wave
array
呼吸波形,入参waveform=true时返回 数据列表
可选
heart_rate_wave
array
心电波形,入参waveform=true时返回 数据列表
可选
right
object
右侧传感器 数据字典
必填
respiration_rate
int
呼吸率 示例:0
必填
heart_rate
int
心率 示例:0
必填
respiratory_wave
array
呼吸波形,入参waveform=true时返回 数据列表
可选
heart_rate_wave
array
心电波形,入参waveform=true时返回 数据列表
可选

说明 / 示例

## 接口地址 ## 成功返回示例 ```language { "ret": 0, "err_code": 0, "msg": "ok", "timestamp": 1751276747743, "mac": "f4:cf:a2:80:48:14", "data": [ { "date": "2025-06-30 17:45:47", "id": 1751276747743, "temperature": 0.0, "humidity": 0.0, "inbed": true, "body_movement": false, "left": { "respiration_rate": 9.5, "heart_rate": 57, "respiratory_wave": [ 1854, 1853, 1862, 1869, 1883, 1892, 1903, 1904, 1912, 1915, 1919, 1920, 1927, 1925, 1925, 1917, 1916, 1910, 1912, 1911, 1920, 1924, 1931, 1936, 1949, 1950, 1952, 1947, 1941, 1930, 1926, 1921, 1919, 1915, 1910, 1910, 1914, 1922, 1915, 1907 ], "heart_rate_wave": [ 50.0, 52.1375, 57.125, 52.1375, 50.0, 52.1375, 40.7375, 57.125, 107.0, 57.125, 27.1999989, 50.0, 52.85, 54.275, 57.125, 59.2625, 57.125, 46.4375, 50.0, 49.2875, 50.0, 52.1375, 55.7, 53.5625, 50.0, 53.5625, 39.3125, 57.125, 107.0, 57.125, 25.0625, 50.0, 50.7125, 52.1375, 57.125, 60.6875, 57.125, 47.8625, 50.0, 47.8625, 50.0, 53.5625, 57.125, 53.5625, 50.0, 53.5625, 39.3125, 57.125, 107.0, 57.125, 25.0625, 50.0, 50.7125, 52.1375, 57.125, 60.6875, 57.125, 47.8625, 50.0, 47.8625 ] }, "right": { "respiration_rate": 0.0, "heart_rate": 0, "respiratory_wave": [ 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888, 1888 ], "heart_rate_wave": [ 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0, 50.0 ] } } ] } ``` >i 注:ret = 0 为成功 ## 失败返回示例 ```language { "ret": 4, "msg": "参数不能为空", "err_code": 10008 } ``` >d 注:ret > 0 为失败 ## 错误编号(errCode): 6 have no permission 9 解析Json出错 35 Mac格式错误 44 设备MAC错误 10008 参数不能为空 10016 Key错误