ICS 01.120
CCS A 00 35
福
建 省 地 方 标 准
DB35/T 2188—2024
海峡两岸共通 智能鞋服数据接口要求
Cross-strait integrated development—Data interface requirements of smart shoes
and clothing
2024 - 07 - 03 发布
2024 - 10 - 03 实施
福建省市场监督管理局 发 布
DB35/T 2188—2024
目
次
前言 ................................................................................. II
引言 ................................................................................ III
1 范围 ............................................................................... 1
2 规范性引用文件 ..................................................................... 1
3 术语和定义 ......................................................................... 1
4 缩略语 ............................................................................. 1
5 接口框架 ........................................................................... 1
6 通用要求 ........................................................................... 2
7 技术要求 ........................................................................... 3
8 接口设计 ........................................................................... 4
附录 A（资料性） 智能鞋服数据接口参数 JSON 代码示例 .................................... 8
I
DB35/T 2188—2024
前
言
本文件按照GB/T 1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规定
起草。
请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。
本文件由福建奇鹭物联网科技股份公司提出。
本文件由福建省信息化标准化技术委员会(SAFJ/TC 11)归口。
本文件起草单位：福建奇鹭物联网科技股份公司、华侨大学计算机科学与技术学院、中科精微（福
建）科技研究院有限责任公司、旭智科技股份有限公司（中国台湾）、台湾半导体协会、深圳亨特智联
网科技有限公司、泉州市拓科信息技术有限公司、泉州市软件行业协会、福建省计算机学会、福建省人
工智能学会、中国移动通信集团福建有限公司泉州分公司、泉州市大数据产业协会、泉州市金同信息科
技有限公司。
本文件主要起草人：林仪清、庄榕榕、王成、范宗文、缑锦、张惠臻、萧宗志（中国台湾）、林瑶
（中国台湾）、方龙祥（中国台湾）、吴楚东。
II
DB35/T 2188—2024
引
言
智能鞋服借助于可穿戴设备让用户的生理、心理，以及感官能力获得了延伸与拓展，将人的动态、
静态各种行为与生命体态特征数据化，具备健康监测、精准定位等功能。通过对鞋服使用者在各场景所
产生的动态数据进行采集、传输、接收、应用，实现传统鞋服无法提供的各类数字化、可视化、智能化
服务，如远程定位、路线规划、运动监测、运动分析、运动管理、智能加热、智能加湿、健康监测、健
康预警等，同时实现鞋服融入万物互联时代和智能制造2025产品端升级迭代，为智能鞋服使用者提供更
高安全保障、科学运动、健康管理等服务，满足人民对美好生活的向往。
智能鞋服在海峡两岸都有使用，是穿戴设备未来的发展方向。智能鞋服的数据接口统一、连通、规
范为海峡两岸鞋服行业智能鞋服的数据采集、传输、管理和应用及相关接口设计提供了技术支撑。智能
鞋服数据接口要求是智能鞋服质量的技术保障，同时也是技术和经济能力的综合反映，在海峡两岸应用
推广有着重要意义。智能鞋服数据接口要求的制定有助于推动智能鞋服在数据接口方面的进步及示范
推广，促进行业管理水平的进一步提升。
III
DB35/T 2188—2024
海峡两岸共通 智能鞋服数据接口要求
1 范围
本文件规定了海峡两岸智能鞋服数据的接口框架、通用要求、技术要求和接口设计。
本文件适用于海峡两岸鞋服行业智能鞋服的数据采集、传输、管理和应用及相关接口设计。
2 规范性引用文件
下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，
仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本
文件。
GB/T 7408.1—2023 日期和时间 信息交换表示法 第1部分：基本原则
3 术语和定义
下列术语和定义适用于本文件。
智能鞋服 smart shoes and clothing
运用传感器、通讯和计算技术，能够获取使用者生命体征数据，并支持数据采集、数据处理和通信
能力的穿戴鞋服。
注： 通常具有多种感知、状态或生理指标监测等功能。
4 缩略语
下列缩略语适用于本文件。
APP：应用程序（Application）
HTTPS：安全超文本传输协议（Hypertext Transfer Protocol Secure）
ID：唯一标识号（Identification）
JSON：JavaScript对象表示法（JavaScript Object Notation）
JWT：JSON网页令牌（JSON Web Token）
OPP：对象存储规范（Object Push Profile）
XML：可扩展标记语言（eXtensible Markup Language）
5 接口框架
智能鞋服的数据接口框架见图1，包含智能鞋服终端、智能鞋服应用、服务端（数据管理、数据处
理与计算），以及数据采集接口、状态监测接口、身份验证接口、数据应用接口。
1
DB35/T 2188—2024
服务端
数据管理模块
数据应用接口 状态监测接口 身份验证接口
用户端
智能鞋服应用端
数据采集接口
智能鞋服终端
图1 智能鞋服数据接口框架
智能鞋服终端采集使用者的相关数据；智能鞋服应用端为用户提供查看位置运动和健康状态可视
化应用；服务端数据管理模块提供数据处理与分析、控制管理接口等服务；数据处理与分析根据用户的
心率、步数等监测数据进行计算处理，并对处理后的数据进一步分析，为用户提供活动模式、睡眠质量
等反馈和建议；控制管理接口能设置智能鞋服开关机状态、检测间隔等。
数据采集接口用于将智能鞋服终端的各类数据传输到智能鞋服应用端，可实时获取智能鞋服使用
者的相关数据。
状态监测接口用于收集、传输智能鞋服相关状态监测数据。
身份验证接口用于验证用户的身份信息，保障合法用户用智能鞋服的功能。
数据应用接口用于将服务端的数据分析挖掘结果和智能鞋服的控制信息传输到应用端。
6 通用要求
智能鞋服数据接口应满足以下要求：
a) 接口支持常见的数据格式，如 JSON、XML 等；
b) Web 接口采用 HTTPS 传输协议；
c) 物联网相关接口采用蓝牙 OPP 等传输协议；
d) 接口采用 JWT 鉴权验证；
e) 数据请求采用 POST 方式；
f) 接口提供错误处理机制，包括错误代码和错误信息。当出现错误时，返回相应的错误提示；
g) 数据交换接口具备互操作性；
h) 接口具备可扩展性；
i) 数据类型及格式见表 1。
2
DB35/T 2188—2024
表1 数据类型及格式说明表
序号 数据类型 数据格式 说明
1 字符型 以大写字母“C”代表字符型： CX：表示定长为“X”的字符型数据元值； C..X：表示最长为“X”的字符型数据元值； C..ul：表示长度不确定的字符型数据元值 一切能显示打印的字 符，包括汉字、字母、数 字、各种符号空格等，不 具有计算能力
2 数值型 以大写字母“NUM”代表数值型： NUM..（X）：表示最长为“X”的数值型数据元值； NUM..（X,y）：表示总长度为“X”位、其中小数点后为“y” 位的数值型数据元值 进行数学运算的数据
3 日期时间型 YYYYMMDD：表示 YYYY 年 MM 月 DD 日的日期格式； YYYYMMDDHHmmss：表示 YYYY 年 MM 月 DD 日 mm 分 ss 秒的时 间格式 采用GB/T 7408.1—2023 的规定用以表示日期及时 间的数据
7 技术要求
数据采集接口
数据采集接口应满足以下要求：
a) 接口的数据字段包括鞋服位置、采集时间、心率、步数、睡眠、温度、湿度等；可根据具体需
求添加其他字段；
b) 接口支持实时或定期更新数据，鞋服位置、采集时间、心率、步数、睡眠、温度、湿度宜实时
更新；其他静态信息宜定期更新。
状态监测接口
状态监测接口内容应包括心率监测、步数监测、睡眠监测、温度监测、湿度监测、位置监测，可包
含通讯/传输状态监测、报错频率/状态监测。状态监测接口满足以下要求：
a) 心率监测：监测用户的心率数据，包括心率变化、心率异常等；
b) 步数监测：监测用户的步行数据，包括步数、睡眠-活动关联等；
c) 睡眠监测：监测用户的睡眠质量，包括睡眠时间、深睡时间、浅睡时间等；
d) 温度监测：监测智能鞋服穿戴温度数据；
e) 湿度监测：监测智能鞋服穿戴湿度数据；
f) 位置监测：监测用户的位置及行走路线；
g) 通讯/传输状态监测：监测数据包的大小、速率；
h) 报错频率/状态监测：监测报错频率/状态。
身份验证接口
身份验证接口的内容包括但不限于：
a) 授权接口：使用平台提供的应用程序密钥，采用 SM2 加密算法生成签名，获取相应的访问令
牌，以取得相应的接口数据请求权限；
b) 验证结果接口：身份验证结果返回。
3
DB35/T 2188—2024
数据应用接口
数据应用接口的内容包括但不限于：
a) 数据处理与分析的接口包括用户位置监测、健康状态监测、智能鞋服使用区域等分析应用；
b) 控制管理的接口包括设置开关机状态、设置温度检测间隔、设置湿度检测间隔、设置心率检测
间隔等。
8 接口设计
数据采集接口
通过硬件设备采集信息。
接口地址：https://IP地址:端口/。
接口类型：websocket。
接口名称：DataCollection。
输入/请求参数：见表2。
输出/返回参数：见表3。
请求示例：见附录A的A.1.1。
返回示例：见附录A的A.1.2。
表2 数据采集接口输入参数表
序号 参数名称 英文名称 数据类型及格式 是否必填 说明
1 设备ID id C32 是 —
2 设备类型 deviceType C1 是 1：鞋；2：服饰；3：其它
3 采集开始时间 beginTime YYYYMMDDHHmmss 是 —
4 采集结束时间 endTime YYYYMMDDHHmmss 是 —
表3 数据采集接口输出参数表
序号 参数名称 英文名称 数据类型及格式 是否必填 说明
1 设备ID id C32 是 —
2 时间 time YYYYMMDDHHmmss 是 当前时间
3 经纬度 longitudeAndLatitude C..50 是 当前位置的经纬度信息
4 响应码 code C1 是 1：成功；0：失败
5 提示信息 message C..200 否 —
6 温度 temperature NUM..（3,1） 是 —
7 湿度 humidity NUM..（3,1） 是 —
8 心率 heartRate NUM..（3） 否 单位为次/分（BPM）
9 步数 steps NUM..（5） 否 —
10 睡眠 sleep NUM..（2） 否 睡眠时长，单位为小时（h）
4
DB35/T 2188—2024
状态监测接口
通过应用端监测智能鞋服穿戴者的心率、步数、温度、湿度、位置等信息。
接口地址：https://IP地址:端口/。
接口类型：websocket。
接口名称：DeviceStateReport。
输入/请求参数：见表4。
输出/返回参数：见表5。
请求示例：见附录A的A.2.1。
返回示例：见附录A的A.2.2。
表4 状态监测接口输入参数表
序号 参数名称 英文名称 数据类型及格式 是否必填 说明
1 设备ID Id C32 是 —
2 设备类型 deviceType C1 是 1：鞋；2：服饰；3：其它
表5 状态监测接口输出参数表
序号 参数名称 英文名称 数据类型及格式 是否必填 说明
1 设备ID id C32 是 —
2 心率 heartRate NUM..（3） 否 单位为次/分（BPM）
3 步数 steps NUM..（5） 否 —
4 睡眠 sleep NUM..（5） 否 单位为秒（S）
5 温度 temperature NUM..（3,1） 是 —
6 湿度 humidity NUM..（3,1） 是 —
7 经纬度 longitudeAndLatitude C..50 是 当前位置的经纬度信息
8 数据包大小 packetSize NUM..（5） 是 单位为字节（B）
9 数据包速率 packetRate NUM..（3,2） 是 单位为兆比特每秒（Mbps）
10 报错频率 errorRate NUM..（3） 是 单位为次/秒
11 响应码 code C1 是 1：成功；0：失败
12 提示信息 message C..200 否 —
13 电量 electricity NUM..（3） 是 —
14 版本 version NUM..（4） 是 —
身份验证接口
通过应用端验证用户访问权限。
接口地址：https://IP地址:端口/。
接口类型：websocket。
接口名称：AuthLogin。
输入/请求参数：见表6。
输出/返回参数：见表7。
请求示例：见附录A的A.3.1。
5
DB35/T 2188—2024
返回示例：见附录A的A.3.2。
表6 身份验证接口输入参数表
序号 参数名称 英文名称 数据类型及格式 是否必填 说明
1 设备ID id C32 是 —
2 应用程序密钥 appKey C..13 是 —
3 随机字符串参数 nonce C..32 是 —
4 时间 time YYYYMMDDHHmmss 是 当前时间
5 签名 sign C32 是 校验签名
表7 身份验证接口输出参数表
序号 参数名称 英文名称 数据类型及格式 是否必填 说明
1 设备ID id C32 是 —
2 响应码 code C1 是 1：成功；0：失败
3 提示信息 message C..200 否 —
4 访问令牌 accessToken C..50 是 使用accessToken进行鉴权
数据应用接口
通过应用端监测用户位置、健康状态、使用区域，以及设置开关机状态、设置温度检测间隔、设置
湿度检测间隔。
接口地址：https://IP地址:端口/。
接口类型：websocket。
接口名称：DataApplication。
输入/请求参数：见表8。
输出/返回参数：见表9。
请求示例：见附录A的A.4.1。
返回示例：见附录A的A.4.2。
表8 数据应用接口输入参数表
序号 参数名称 英文名称 数据类型及格式 是否必填 说明
1 设备ID id C32 是 —
2 设备类型 deviceType C1 是 1：鞋；2：服饰3：其它
6
DB35/T 2188—2024
表9 数据应用接口输出参数表
序号 参数名称 英文名称 数据类型及格式 是否必填 说明
1 设备ID id C32 是 —
2 经纬度 longitudeAndLatitude C..50 是 当前位置的经纬度信息
3 健康状态 healthStatus C1 是 1：心率太快；2：心率太慢； 3：温度过高；4：温度过低； 5：湿度过高；6：湿度过低
4 所在区域 region C..32 是 —
5 开关机状态 onOffState C1 是 1：开机状态；2：关机状态
6 温度检测间隔 temperatureInterval NUM..（3） 是 单位为分钟（min）
7 湿度检测间隔 humidityInterval NUM..（3） 是 单位为分钟（min）
8 心率检测间隔 heartRateInterval NUM..（3） 是 单位为分钟（min）
9 响应码 code C1 是 1：成功；0：失败
10 提示信息 message C..200 否 —
7
DB35/T 2188—2024
附 录 A
（资料性）
智能鞋服数据接口参数 JSON 代码示例
A.1 数据采集接口
A.1.1 请求示例
{
"id": "12321431232324353233133353233133",
"deviceType":"1",
"beginTime": "2023-08-11 14:00:00",
"endTime": "2023-08-11 15:00:00"
}
A.1.2 响应示例
{
"id": "35323313312321431232324353233133",
"locations": [
{"time":"2023-08-11 14:02:23","longitudeAndLatitude":"113.58762,37.86236"},
{"time":"2023-08-11 14:05:23","longitudeAndLatitude":"113.58762,37.86221"}],
"code": "1",
"message": "数据采集正常",
"temperature": "40.4",
"humidity": "20.5",
"heartRate": "70",
"steps": "1000",
"sleep": "8"
}
A.2 状态监测接口
A.2.1 请求示例
{
"id": "35323313312321431232324353233123",
"deviceType": "1"
}
8
DB35/T 2188—2024
A.2.2 响应示例
{
"id": "12323532331331431232324353233123",
"heartRate": "70",
"steps": "1000",
"sleep": "28800",
"temperature": "40.4",
"humidity": "20.5",
"longitudeAndLatitude":"113.58762,37.86236",
"packetSize":"1518",
"packetRate": "10.00",
"errorRate": "2",
"code":"1",
"message": "监测状态正常",
"electricity": "50",
"version":"10"
}
A.3 身份验证接口
A.3.1 请求示例
{
"id": "12321431233532331332324353233133",
"appKey":"qiloo_app_key",
"nonce": "doloreproidentnisimollitdolor",
"time":"2023-08-11 14:05:23",
"sign": "69af8e7013cff322dde2e27fccfdbc05"
}
A.3.2 响应示例
{
"id": "12321431232324353532331333233133",
"code": "1",
"message": "身份验证成功",
"accessToken": "12af8e2001cff178aab2e27fxxfdbc89"
9
DB35/T 2188—2024
}
A.4 数据应用接口
A.4.1 请求示例
{
"id": "89353233133321431232324353233123",
"deviceType": "1"
}
A.4.2 响应示例
{
"id": "89321431232353233133324353233123",
"longitudeAndLatitude":"113.58762,37.86236",
"healthStatus"："1",
"region":"福建省泉州市丰泽区古道街 66 号",
"onOffState":"1",
"temperatureInterval":"100",
"humidityInterval":"50",
"heartRateInterval":"60",
"code": "1",
"message": "操作成功"
}
10