API接口——睡眠带开放能力
本文介绍睡眠带相关接口。
API 列表
| 请求方法 | API | 描述 |
|---|---|---|
| GET | /v1.0/devices/{device_id}/sleep/daily-reports | 获取日睡眠报告。 |
| GET | /v1.0/devices/{device_id}/sleep/monthly-reports | 获取月睡眠报告。 |
| GET | /v1.0/devices/{device_id}/sleep/24h-reports | 获取 24 小时睡眠报告。 |
| GET | /v1.0/devices/{device_id}/sleep/preview/reports | 预览睡眠报告状态。 |
| PUT | /v1.0/devices/{device_id}/sleep/reports/{report_id} | 更新报告状态。 |
获取日睡眠报告
功能描述
获取日睡眠报告。
接口地址
GET /v1.0/devices/{device_id}/sleep/daily-reports
请求参数
| 参数名 | 类型 | 参数类型 | 说明 | 必填 |
|---|---|---|---|---|
| device_id | String | URI | 设备 ID。 | 是 |
| report_time | Long | URL | 获取设备所在时区报告的时间戳（精确到秒）。 | 是 |
返回参数
| 参数名 | 参数类型 | 描述 |
|---|---|---|
| success | Boolean | 是否成功：
|
| status | String | 状态 |
| t | Long | 13 位标准时间戳 |
| result | List | 返回结果 |
Result
| 参数名 | 参数类型 | 描述 |
|---|---|---|
| reports | List | 睡眠报告 |
Reports
| 参数名 | 参数类型 | 描述 |
|---|---|---|
| report_id | Long | 报告 ID。 |
| data_date | Long | 报告时间，精确到秒。 |
| start_time | Long | 睡眠起始时间，精确到秒。 |
| duration | Int | 睡觉总时长，单位秒。 |
| wake | Int | 清醒总时间，单位秒。 |
| out_of_bed_duration | Int | 离床时长，单位秒。 |
| sleep_status | Int | 睡眠状态：
|
| avg_breath_rate | Int | 平均呼吸率。 |
| avg_heart_rate | Int | 平均心率。 |
| snore_number | Int | 鼾声次数。 |
| snore_duration | Int | 鼾声总时长。 |
| snore_high_proportion | Int | 鼾声程度为高的比例。 |
| snore_mid_proportion | Int | 鼾声程度为中的比例。 |
| snore_low_proportion | Int | 鼾声程度为低的比例。 |
| snore_non_proportion | Int | 鼾声程度为无的比例。 |
请求示例
GET /v1.0/devices/vedeo887723I****/sleep/daily-reports?report_time=1594887507
返回示例
{"result": {"reports": [{"avg_breath_rate": 15,"avg_heart_rate": 56,"data_date": 1596577259,"duration": 238,"out_of_bed_duration": 528,"start_time": 1596477259,"wake": 205}]},"success": true,"t": 1597115614003
}
错误码
以下为该接口常见的业务异常，更多的异常错误，参见全局错误码。
| 错误码 | 说明 |
|---|---|
| 500 | 系统错误 |
获取月睡眠报告
功能描述
获取月睡眠报告。
接口地址
GET /v1.0/devices/{device_id}/sleep/monthly-reports
请求参数
| 参数名 | 类型 | 参数类型 | 说明 | 必填 |
|---|---|---|---|---|
| device_id | String | URI | 设备 ID。 | 是 |
| report_time | Long | URL | 获取设备所在时区报告的时间戳（精确到秒）。 | 是 |
返回参数
| 参数名 | 参数类型 | 描述 |
|---|---|---|
| success | Boolean | 是否成功：
|
| status | String | 状态 |
| t | Long | 13 位标准时间戳 |
| result | List | 返回结果 |
Result
| 参数名 | 参数类型 | 描述 |
|---|---|---|
| reports | List | 睡眠报告 |
Reports
| 参数名 | 参数类型 | 描述 |
|---|---|---|
| reportId | String | 报告 ID。 |
| time | Integer | 时间。 |
| pos | Integer | 周或月在指定年份的位置。例如，周接口中指定"pos": 8, 表示 2020 年的第 8 周。 |
| year | Integer | 报告的年份。 |
| days | Integer | 记录的天数 |
| score | Int | 平均分数。 |
| scoreValue | Int[] | 分数列表。 |
| avg_sleep_time | Int | 平均睡眠时长，单位秒。 |
| avg_fallasleep_time | Int | 平均入睡时长，单位秒。 |
| sleep_time_value | Int[] | 实际睡眠时长列表，单位秒。 |
| fallasleep_time_value | Int[] | 入睡时长列表，单位秒。 |
| avg_sleep_percentage | Int | 平均睡眠效率。 |
| avg_deepsleep_percentage | Int | 平均深睡比例。 |
| sleep_percentage_value | Int[] | 睡眠效率列表。 |
| deepsleep_percentage_value | Int[] | 深睡比例列表。 |
| sleep_rule_status | Int | 睡眠规律：
|
| start_sleep_value | List | 开始睡觉时间列表。 |
| wakeup_value | List | 清醒时间列表。 |
| avg_breath_rate | Int | 平均呼吸率。 |
| breath_rate_value | Int[] | 呼吸率列表。 |
| avg_heart_rate | Int | 平均心率。 |
| heart_rate_value | Int[] | 心率列表。 |
| avg_inbed_time | Int | 平均赖床时长，单位秒。 |
| inbed_time_value | Int[] | 赖床时长列表，单位秒。 |
| avgawake_times | Int | 平均清醒次数。 |
| awake_times_value | Int[] | 清醒次数列表。 |
| avg_outofbed_times | Int | 起床次数。 |
| outofbed_times_cnt | Int | 离床次数。 |
| outofbed_times_value | Int[] | 起床次数列表。 |
| factors | String | 周月状态值：
|
| score_perc | String | 分数占比状态：
|
| sleep_hour_more9days | Int | 睡眠时长超过 9 个小时的天数。 |
| sleep_hour_less6days | Int | 睡眠时长少于 6 个小时的天数。 |
| heartbeat_pause_days | Int | 心跳过缓天数。 |
| apnea_days | Int | 呼吸过缓天数。 |
| avgSnore_time | Int | 平均鼾声时长。 |
| snore_time_value | Int[] | 鼾声时长列表。 |
请求示例
GET /v1.0/devices/vedeo74882653500291/sleep/monthly-reports?report_time=1594887507
返回参数
{"result": {"reports": [{"apnea_days": 4,"avg_breath_rate": 15,"avg_deepsleep_percentage": 14,"avg_fallasleep_time": 24,"avg_heart_rate": 57,"avg_inbed_time": 55,"avg_outofbed_times": 5,"avg_sleep_percentage": 54,"avg_sleep_time": 297,"avg_snore_time": 0,"avgawake_times": 5,"awake_times_value": [3,2,2,9,0,10,11,-1,4,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1],"breath_rate_value": [15,15,15,15,15,15,15,-1,15,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1],"days": 8,"deepsleep_percentage_value": [6,11,0,21,46,0,3,-1,23,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1],"factors": "1,1,1,0,0","fallasleep_time_value": [37,5,58,5,5,57,10,-1,15,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1],"heart_rate_value": [56,56,56,59,60,57,59,-1,56,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1],"heartbeat_pause_days": 0,"inbed_time_value": [125,42,125,49,4,11,59,-1,22,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1],"outofbed_times_cnt": 7,"outofbed_times_value": [2,1,2,9,0,9,10,-1,4,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1],"pos": 8,"score": 48,"score_perc": "0,0,6,19,75","score_value": [54,48,34,61,36,32,45,-1,74,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1],"sleep_hour_less6days": 8,"sleep_hour_more9days": 1,"sleep_percentage_value": [34,85,13,58,98,38,40,-1,67,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1],"sleep_rule_status": 1,"sleep_time_value": [133,377,55,283,666,296,238,-1,328,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1],"snore_time_value": [-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1,-1],"start_sleep_value": ["00:04","23:43","01:54","00:29","00:07","23:54","23:40","","23:43","","","","","","","","","","","","","","","","","","","","","",""],"time": 1596211200,"wakeup_value": ["04:59","06:47","05:52","06:06","11:22","05:58","04:47","","05:48","","","","","","","","","","","","","","","","","","","","","",""],"year": 2020}]},"success": true,"t": 1597073472399
}
错误码
以下为该接口常见的业务异常，更多的异常错误，参见全局错误码。
| 错误码 | 说明 |
|---|---|
| 500 | 系统错误 |
获取 24 小时睡眠报告
功能描述
获取 24 小时睡眠报告。
接口地址
GET /v1.0/devices/{device_id}/sleep/24h-reports
请求参数
| 参数名 | 类型 | 参数类型 | 说明 | 必填 |
|---|---|---|---|---|
| device_id | String | URI | 设备 ID。 | 是 |
| report_time | Long | URL | 获取设备所在时区报告的时间戳（精确到秒）。 | 是 |
返回参数
| 参数名 | 参数类型 | 描述 |
|---|---|---|
| success | Boolean | 是否成功：
|
| status | String | 状态 |
| t | Long | 13 位标准时间戳 |
| result | List | 返回结果 |
result 说明
| 参数名 | 参数类型 | 描述 |
|---|---|---|
| report_id | Long | 报告 ID |
| start_time | Long | 睡眠起始时间 |
| duration | Int | 睡觉总时长 |
| wake | Int | 清醒总时间 |
| out_of_bed_duration | Int | 离床时长 |
| sleep_status | Int[] | 睡眠状态 |
| avg_breath_rate | Int | 平均呼吸率 |
| avg_heart_rate | Int | 平均心率 |
| snore_number | Int | 鼾声次数 |
| snore_duration | Int | 鼾声总时长 |
| snore_high_proportion | Int | 鼾声程度为高的比例 |
| snore_mid_proportion | Int | 鼾声程度为中的比例 |
| snore_low_proportion | Int | 鼾声程度为低的比例 |
| snore_non_proportion | Int | 鼾声程度为无的比例 |
请求示例
GET /v1.0/devices/vedeo8877237278/sleep/24h-reports?report_time=1594887507
返回示例
{"result": {"reports": [{"avg_breath_rate": 15,"avg_heart_rate": 56,"duration": 238,"out_of_bed_duration": 528,"start_time": 1596477259,"wake": 205}]},"success": true,"t": 1597115614003
}
错误码
以下为该接口常见的业务异常，更多的异常错误，请参见全局错误码。
| 错误码 | 说明 |
|---|---|
| 500 | 系统错误 |
预览睡眠报告状态
功能描述
预览睡眠报告状态。
接口地址
GET /v1.0/devices/{device_id}/sleep/preview/reports
请求参数
| 参数名 | 类型 | 参数类型 | 说明 | 必填 |
|---|---|---|---|---|
| device_id | String | URI | 设备 ID。 | 是 |
| start_time | Long | URL | 设备所在时区开始时间的时间戳（精确到秒）。 | 是 |
| end_time | Long | URL | 设备所在时区结束时间的时间戳（精确到秒）。 | 是 |
返回参数
| 参数名 | 参数类型 | 描述 |
|---|---|---|
| success | Boolean | 是否成功：
|
| status | String | 状态 |
| t | Long | 13 位标准时间戳 |
| result | List | 返回结果 |
Result
| 参数名 | 参数类型 | 描述 |
|---|---|---|
| report_id | String | 报告 ID。 |
| data_date | String | 查询时间，格式为yyyy-MM-dd。 |
| read_state | Boolean | 是否已读：
|
请求示例
GET /v1.0/devices/vedeo53424223/sleep/preview/reports？start_time=1590984264&end_time=1593489864
返回示例
{"result":[{"data_date": "2020-08-03","read_state": true,"report_id": 1355686}],"t":1594979100693,"success":true,"status":"ok"
}
错误码
以下为该接口常见的业务异常，更多的异常错误，请参见全局错误码。
| 错误码 | 说明 |
|---|---|
| 500 | 系统错误 |
更新报告状态
功能描述
更新报告读取状态。
接口地址
PUT /v1.0/devices/{device_id}/sleep/reports/{report_id}
请求参数
| 参数名 | 类型 | 参数类型 | 说明 | 必填 |
|---|---|---|---|---|
| device_id | String | URI | 设备 ID | 是 |
| report_id | Long | URL | 报告 ID | 是 |
返回参数
| 参数名 | 类型 | 说明 |
|---|---|---|
| code | Integer | 错误码。 |
| success | Boolean | 是否成功：
|
| msg | String | 请求失败的信息，成功为空。 |
| result | Boolean | 返回结果。 |
请求示例
PUT /v1.0/devices/vedeo623232/sleep/reports/10002
返回示例
{ "result":true, "t":1542776517323 }
错误码
以下为该接口常见的业务异常，更多的异常错误，请参见全局错误码。
| 错误码 | 说明 |
|---|---|
| 500 | 系统错误 |
相关文章：
API接口——睡眠带开放能力
本文介绍睡眠带相关接口。 API 列表 请求方法API描述GET/v1.0/devices/{device_id}/sleep/daily-reports获取日睡眠报告。GET/v1.0/devices/{device_id}/sleep/monthly-reports获取月睡眠报告。GET/v1.0/devices/{device_id}/sleep/24h-reports获取 24 小时睡眠报告。GET/v1.…...
面向对象的一点小想法
接口里的方法可以写也可以不写 如果写的话，那么得是默认方法，需要在前面加个default 对于默认方法，能够重写，或者直接继承（也就是直接用） 比如下面： 就直接调用了接口的默认函数nibuhao&#…...
数据仓库工作问题总结
1. ODS 层采用什么压缩方式和存储格式？ 压缩采用 Snappy ，存储采用 orc ，压缩比是 100g 数据压缩完 10g 左右。 2. DWD 层做了哪些事？ 1.、数据清洗 空值去除过滤核心字段无意义的数据，比如订单表中订单 id 为 nul…...
Java常用算法
关于时间复杂度： 平方阶 (O(n2)) 排序 各类简单排序：直接插入、直接选择和冒泡排序。线性对数阶 (O(nlog2n)) 排序 快速排序、堆排序和归并排序。O(n1)) 排序， 是介于 0 和 1 之间的常数。希尔排序。线性阶 (O(n)) 排序 基数排序，…...
插画网课平台排名
插画网课平台哪个好，插画网课排名靠前的有哪些，今天给大家梳理了国内5家专业的插画网课平台，各有优势和特色，给学插画的小伙伴提供选择，报插画网课一定要选择靠谱的，否则人钱两空泪两行！ 一&am…...
雷达、定位、跟踪等信号处理邻域SCI期刊整理及推荐
雷达邻域SCI期刊整理及推荐：题名、刊物信息、撰写特点、审稿周期及投稿难度总结 定位/跟踪邻域SCI期刊整理及推荐：题名、刊物信息、撰写特点、审稿周期及投稿难度总结 估计/滤波/融合等信号处理邻域SCI期刊整理及推荐：题名、刊物信息、撰写…...
NDK C++ 指针常量 常量指针 常量指针常量
指针常量 常量指针 常量指针常量// 指针常量 常量指针 常量指针常量#include <iostream> #include <string.h> #include <string.h>using namespace std;int main() {// *strcpy (char *__restrict, const char *__restrict);// strcpy()int number 9;int n…...
常见前端基础面试题（HTML,CSS,JS）（一）
html语义化的理解 代码结构: 使页面在没有css的情况下,也能够呈现出好的内容结构 有利于SEO: 爬虫根据标签来分配关键字的权重,因此可以和搜索引擎建立良好的沟通,帮助爬虫抓取更多的有效信息 方便其他设备解析： 如屏幕阅读器、盲人阅读器、移动设备等，…...
Delphi RSA加解密
感谢、感谢、感谢大佬的分享，https://github.com/ZYHPRO/RSAEncryptAndDecode 目录 1. 前言 2. 准备工作 3. Demo注意事项说明 3.1 公钥、私钥文本格式 3.2 回车键的影响 3.3 中文加解密说明 4. 结语 1. 前言 最近工作上安排了一个项目，与工商银行之…...
oracle基本操作
文章目录基本操作用户权限管理：权限传递：角色管理：数据导出：对于远程数据库查看表空间查看表空间路径查看被锁的对象基本操作 connect sys/zxm as sysdba-- 用 sys用户登录 create user jsdx identified by jsdx 创建用户 jsdx 密…...
hive只复制表结构不复制表数据
目录 一、背景 二、准备测试数据 1.建表 2.造测试数据 三、操作 1.CTAS （1）.无分区表测试 （2）.分区表测试 2.LIKE （1）.无分区表测试 （2）.分区表测试 一、背景 有一张ori_…...
如何将Linux的NIC 名称更改为 eth0 而不是 enps33 或 enp0s25，只要几秒钟
概述 我们使用Linux系统，网卡名称通常都是eth0，但是有一些新的linux发行版，网卡名字 enps33 或 enp0s25。 pengubuntu:~$ ifconfig ens33 Link encap:Ethernet HWaddr 00:0c:29:fd:4d:3a inet addr:192.168.0.113 Bcast:192.168.0.…...
位运算笔记
1. 为什么要学位运算 因为这是计算机内部运算的语言，所以会非常快。 本人是因为学习算法经常遇见一些求二进制中的0和1的各种操作，好多都不知道所以特此整理一下，如有不对，烦请指正。 2. 什么是位运算 程序中的所有数在计算机内存…...
2023全国首个区块链平台发布，区块链绿色消费积分系统玩法悄然上市
全国首个区块链平台发布，区块链绿色消费积分系统玩法悄然上市 2023-02-23 16:15梦龙 大家好，我是你们熟悉而又陌生的好朋友梦龙，一个创业期的年轻人 2月22日，首届中国数字产权创新大会在成都举办。在本次大会上，全国…...
【异常】因为忘加了租户查询条件，导致重复ID导入失败Duplicate entry ‘XXX‘ for key ‘PRIMARY‘
一、异常说明 Error updating database. Cause: java.sql.SQLIntegrityConstraintViolationException: Duplicate entry 670 for key PRIMARYThe error may exist in /mall/admin/mapper/GoodsCategoryMapper.java (best guess)The error may involve .admin.mapper.GoodsCate…...
证明CPU指令是乱序执行的
承接上文CPU缓存一致性原理双击QQ.exe从磁盘加载到内存里面，内存里面就会有了一个进程，进程产生的时候会产生一个主线程，就是main方法所在的线程，cpu会找到main开始的地方，把它的指令读取过来放到程序计数器࿰…...
css 属性和属性值的定义
文章目录css文本属性作业列表属性背景属性作业css文本属性 序号属性描述说明1font-size字体大小浏览器默认16px；2font-family字体当字体是中文字体，英文字体，中间有空格时候，要加双引号，多字体之间用逗号隔开 默认微软…...
Python获取中国大学MOOC某课程评论及其参与人数
文章目录前言一、需求二、分析三、运行结果前言 本系列文章来源于真实的需求本系列文章你来提我来做本系列文章仅供学习参考 一、需求 1、课程参加人数 2、课程学员名称及其评论 二、分析 首先查看网页源代码是否有需要的数据 课程参加人数 课程学员名称及其评论 F12 打开浏…...
【C++】类和对象（完结篇）
文章目录1. 再谈构造函数1.1 初始化列表1.2 explicit关键字2. static 成员2.1 静态成员变量2.1 静态成员函数2.3 练习2.4 总结3. 匿名对象4. 友元4.1 友元函数4.2 友元类5. 内部类6. 拷贝对象时编译器的一些优化7. 再次理解类和对象这篇文章呢，我们来再来对类和对象…...
低代码开发可以解决哪些问题？
低代码开发可以解决哪些问题？如果用4句话去归纳，低代码开发可以解决以下问题—— 为企业提供更高的灵活性，用户可以突破代码的限制自主开发业务应用；通过减少对专业软件开发人员的依赖，公司可以快速响应市场上的新业务…...
)
椭圆曲线密码学(ECC)
一、ECC算法概述 椭圆曲线密码学（Elliptic Curve Cryptography）是基于椭圆曲线数学理论的公钥密码系统，由Neal Koblitz和Victor Miller在1985年独立提出。相比RSA，ECC在相同安全强度下密钥更短（256位ECC ≈ 3072位RSA…...
以下是对华为 HarmonyOS NETX 5属性动画（ArkTS）文档的结构化整理，通过层级标题、表格和代码块提升可读性：
一、属性动画概述NETX 作用：实现组件通用属性的渐变过渡效果，提升用户体验。支持属性：width、height、backgroundColor、opacity、scale、rotate、translate等。注意事项： 布局类属性（如宽高）变化时&#…...
Day131 | 灵神 | 回溯算法 | 子集型 子集
Day131 | 灵神 | 回溯算法 | 子集型 子集 78.子集 78. 子集 - 力扣（LeetCode） 思路： 笔者写过很多次这道题了，不想写题解了，大家看灵神讲解吧 回溯算法套路①子集型回溯【基础算法精讲 14】_哔哩哔哩_bilibili 完…...
python/java环境配置
环境变量放一起 python： 1.首先下载Python Python下载地址：Download Python | Python.org downloads ---windows -- 64 2.安装Python 下面两个，然后自定义，全选 可以把前4个选上 3.环境配置 1）搜高级系统设置 2…...
AtCoder 第409场初级竞赛 A~E题解
A Conflict 【题目链接】 原题链接：A - Conflict 【考点】 枚举 【题目大意】 找到是否有两人都想要的物品。 【解析】 遍历两端字符串，只有在同时为 o 时输出 Yes 并结束程序，否则输出 No。 【难度】 GESP三级 【代码参考】 #i…...
LeetCode - 394. 字符串解码
题目 394. 字符串解码 - 力扣（LeetCode） 思路 使用两个栈：一个存储重复次数，一个存储字符串 遍历输入字符串： 数字处理：遇到数字时，累积计算重复次数左括号处理：保存当前状态&a…...
解决本地部署 SmolVLM2 大语言模型运行 flash-attn 报错
出现的问题 安装 flash-attn 会一直卡在 build 那一步或者运行报错 解决办法 是因为你安装的 flash-attn 版本没有对应上，所以报错，到 https://github.com/Dao-AILab/flash-attention/releases 下载对应版本，cu、torch、cp 的版本一定要对…...
三体问题详解
从物理学角度，三体问题之所以不稳定，是因为三个天体在万有引力作用下相互作用，形成一个非线性耦合系统。我们可以从牛顿经典力学出发，列出具体的运动方程，并说明为何这个系统本质上是混沌的，无法得到一般解…...
QT： `long long` 类型转换为 `QString` 2025.6.5
在 Qt 中，将 long long 类型转换为 QString 可以通过以下两种常用方法实现： 方法 1：使用 QString::number() 直接调用 QString 的静态方法 number()，将数值转换为字符串： long long value 1234567890123456789LL; …...
Android 之 kotlin 语言学习笔记三（Kotlin-Java 互操作）
参考官方文档：https://developer.android.google.cn/kotlin/interop?hlzh-cn 一、Java（供 Kotlin 使用） 1、不得使用硬关键字 不要使用 Kotlin 的任何硬关键字作为方法的名称 或字段。允许使用 Kotlin 的软关键字、修饰符关键字和特殊标识…...