DB35∕T 2188-2024 海峡两岸共通 智能鞋服数据接口要求

ICS01.120

CCSA00

35

福建省地方标准

DB35/T2188—2024

海峡两岸共通智能鞋服数据接口要求

Cross-straitintegrateddevelopment—Datainterfacerequirementsofsmartshoes

andclothing

2024-07-03发布2024-10-03实施

福建省市场监督管理局发布

DB35/T2188—2024

目次

前言.................................................................................II

引言................................................................................III

1范围...............................................................................1

2规范性引用文件.....................................................................1

3术语和定义.........................................................................1

4缩略语.............................................................................1

5接口框架...........................................................................1

6通用要求...........................................................................2

7技术要求...........................................................................3

8接口设计...........................................................................4

附录A（资料性）智能鞋服数据接口参数JSON代码示例....................................8

I

DB35/T2188—2024

前言

本文件按照GB/T1.1—2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定

起草。

请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。

本文件由福建奇鹭物联网科技股份公司提出。

本文件由福建省信息化标准化技术委员会(SAFJ/TC11)归口。

本文件起草单位：福建奇鹭物联网科技股份公司、华侨大学计算机科学与技术学院、中科精微（福

建）科技研究院有限责任公司、旭智科技股份有限公司（中国台湾）、台湾半导体协会、深圳亨特智联

网科技有限公司、泉州市拓科信息技术有限公司、泉州市软件行业协会、福建省计算机学会、福建省人

工智能学会、中国移动通信集团福建有限公司泉州分公司、泉州市大数据产业协会、泉州市金同信息科

技有限公司。

本文件主要起草人：林仪清、庄榕榕、王成、范宗文、缑锦、张惠臻、萧宗志（中国台湾）、林瑶

（中国台湾）、方龙祥（中国台湾）、吴楚东。

II

DB35/T2188—2024

引言

智能鞋服借助于可穿戴设备让用户的生理、心理，以及感官能力获得了延伸与拓展，将人的动态、

静态各种行为与生命体态特征数据化，具备健康监测、精准定位等功能。通过对鞋服使用者在各场景所

产生的动态数据进行采集、传输、接收、应用，实现传统鞋服无法提供的各类数字化、可视化、智能化

服务，如远程定位、路线规划、运动监测、运动分析、运动管理、智能加热、智能加湿、健康监测、健

康预警等，同时实现鞋服融入万物互联时代和智能制造2025产品端升级迭代，为智能鞋服使用者提供更

高安全保障、科学运动、健康管理等服务，满足人民对美好生活的向往。

智能鞋服在海峡两岸都有使用，是穿戴设备未来的发展方向。智能鞋服的数据接口统一、连通、规

范为海峡两岸鞋服行业智能鞋服的数据采集、传输、管理和应用及相关接口设计提供了技术支撑。智能

鞋服数据接口要求是智能鞋服质量的技术保障，同时也是技术和经济能力的综合反映，在海峡两岸应用

推广有着重要意义。智能鞋服数据接口要求的制定有助于推动智能鞋服在数据接口方面的进步及示范

推广，促进行业管理水平的进一步提升。

III

DB35/T2188—2024

海峡两岸共通智能鞋服数据接口要求

1范围

本文件规定了海峡两岸智能鞋服数据的接口框架、通用要求、技术要求和接口设计。

本文件适用于海峡两岸鞋服行业智能鞋服的数据采集、传输、管理和应用及相关接口设计。

2规范性引用文件

下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件，

仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本

文件。

GB/T7408.1—2023日期和时间信息交换表示法第1部分：基本原则

3术语和定义

下列术语和定义适用于本文件。

智能鞋服smartshoesandclothing

运用传感器、通讯和计算技术，能够获取使用者生命体征数据，并支持数据采集、数据处理和通信

能力的穿戴鞋服。

注：通常具有多种感知、状态或生理指标监测等功能。

4缩略语

下列缩略语适用于本文件。

APP：应用程序（Application）

HTTPS：安全超文本传输协议（HypertextTransferProtocolSecure）

ID：唯一标识号（Identification）

JSON：JavaScript对象表示法（JavaScriptObjectNotation）

JWT：JSON网页令牌（JSONWebToken）

OPP：对象存储规范（ObjectPushProfile）

XML：可扩展标记语言（eXtensibleMarkupLanguage）

5接口框架

智能鞋服的数据接口框架见图1，包含智能鞋服终端、智能鞋服应用、服务端（数据管理、数据处

理与计算），以及数据采集接口、状态监测接口、身份验证接口、数据应用接口。

1

DB35/T2188—2024

服务端

数据管理模块

状态监测接口身份验证接口

数据应用接口

用户端

智能鞋服应用端

数据采集接口

智能鞋服终端

图1智能鞋服数据接口框架

智能鞋服终端采集使用者的相关数据；智能鞋服应用端为用户提供查看位置运动和健康状态可视

化应用；服务端数据管理模块提供数据处理与分析、控制管理接口等服务；数据处理与分析根据用户的

心率、步数等监测数据进行计算处理，并对处理后的数据进一步分析，为用户提供活动模式、睡眠质量

等反馈和建议；控制管理接口能设置智能鞋服开关机状态、检测间隔等。

数据采集接口用于将智能鞋服终端的各类数据传输到智能鞋服应用端，可实时获取智能鞋服使用

者的相关数据。

状态监测接口用于收集、传输智能鞋服相关状态监测数据。

身份验证接口用于验证用户的身份信息，保障合法用户用智能鞋服的功能。

数据应用接口用于将服务端的数据分析挖掘结果和智能鞋服的控制信息传输到应用端。

6通用要求

智能鞋服数据接口应满足以下要求：

a)接口支持常见的数据格式，如JSON、XML等；

b)Web接口采用HTTPS传输协议；

c)物联网相关接口采用蓝牙OPP等传输协议；

d)接口采用JWT鉴权验证；

e)数据请求采用POST方式；

f)接口提供错误处理机制，包括错误代码和错误信息。当出现错误时，返回相应的错误提示；

g)数据交换接口具备互操作性；

h)接口具备可扩展性；

i)数据类型及格式见表1。

2

DB35/T2188—2024

表1数据类型及格式说明表

序号数据类型数据格式说明

以大写字母“C”代表字符型：一切能显示打印的字

CX：表示定长为“X”的字符型数据元值；符，包括汉字、字母、数

1字符型

C..X：表示最长为“X”的字符型数据元值；字、各种符号空格等，不

C..ul：表示长度不确定的字符型数据元值具有计算能力

以大写字母“NUM”代表数值型：

NUM..（X）：表示最长为“X”的数值型数据元值；

2数值型进行数学运算的数据

NUM..（X,y）：表示总长度为“X”位、其中小数点后为“y”

位的数值型数据元值

YYYYMMDD：表示YYYY年MM月DD日的日期格式；采用GB/T7408.1—2023

3日期时间型YYYYMMDDHHmmss：表示YYYY年MM月DD日mm分ss秒的时的规定用以表示日期及时

间格式间的数据

7技术要求

数据采集接口

数据采集接口应满足以下要求：

a)接口的数据字段包括鞋服位置、采集时间、心率、步数、睡眠、温度、湿度等；可根据具体需

求添加其他字段；

b)接口支持实时或定期更新数据，鞋服位置、采集时间、心率、步数、睡眠、温度、湿度宜实时

更新；其他静态信息宜定期更新。

状态监测接口

状态监测接口内容应包括心率监测、步数监测、睡眠监测、温度监测、湿度监测、位置监测，可包

含通讯/传输状态监测、报错频率/状态监测。状态监测接口满足以下要求：

a)心率监测：监测用户的心率数据，包括心率变化、心率异常等；

b)步数监测：监测用户的步行数据，包括步数、睡眠-活动关联等；

c)睡眠监测：监测用户的睡眠质量，包括睡眠时间、深睡时间、浅睡时间等；

d)温度监测：监测智能鞋服穿戴温度数据；

e)湿度监测：监测智能鞋服穿戴湿度数据；

f)位置监测：监测用户的位置及行走路线；

g)通讯/传输状态监测：监测数据包的大小、速率；

h)报错频率/状态监测：监测报错频率/状态。

身份验证接口

身份验证接口的内容包括但不限于：

a)授权接口：使用平台提供的应用程序密钥，采用SM2加密算法生成签名，获取相应的访问令

牌，以取得相应的接口数据请求权限；

b)验证结果接口：身份验证结果返回。

3

DB35/T2188—2024

数据应用接口

数据应用接口的内容包括但不限于：

a)数据处理与分析的接口包括用户位置监测、健康状态监测、智能鞋服使用区域等分析应用；

b)控制管理的接口包括设置开关机状态、设置温度检测间隔、设置湿度检测间隔、设置心率检测

间隔等。

8接口设计

数据采集接口

通过硬件设备采集信息。

接口地址：https://IP地址:端口/。

接口类型：websocket。

接口名称：DataCollection。

输入/请求参数：见表2。

输出/返回参数：见表3。

请求示例：见附录A的A.1.1。

返回示例：见附录A的A.1.2。

表2数据采集接口输入参数表

序号参数名称英文名称数据类型及格式是否必填说明

1设备IDidC32是—

2设备类型deviceTypeC1是1：鞋；2：服饰；3：其它

3采集开始时间beginTimeYYYYMMDDHHmmss是—

4采集结束时间endTimeYYYYMMDDHHmmss是—

表3数据采集接口输出参数表

序号参数名称英文名称数据类型及格式是否必填说明

1设备IDidC32是—

2时间timeYYYYMMDDHHmmss是当前时间

3经纬度longitudeAndLatitudeC..50是当前位置的经纬度信息

4响应码codeC1是1：成功；0：失败

5提示信息messageC..200否—

6温度temperatureNUM..（3,1）是—

7湿度humidityNUM..（3,1）是—

8心率heartRateNUM..（3）否单位为次/分（BPM）

9步数stepsNUM..（5）否—

10睡眠sleepNUM..（2）否睡眠时长，单位为小时（h）

4

DB35/T2188—2024

状态监测接口

通过应用端监测智能鞋服穿戴者的心率、步数、温度、湿度、位置等信息。

接口地址：https://IP地址:端口/。

接口类型：websocket。

接口名称：DeviceStateReport。

输入/请求参数：见表4。

输出/返回参数：见表5。

请求示例：见附录A的A.2.1。

返回示例：见附录A的A.2.2。

表4状态监测接口输入参数表

序号参数名称英文名称数据类型及格式是否必填说明

1设备IDIdC32是—

2设备类型deviceTypeC1是1：鞋；2：服饰；3：其它

表5状态监测接口输出参数表

序号参数名称英文名称数据类型及格式是否必填说明

1设备IDidC32是—

2心率heartRateNUM..（3）否单位为次/分（BPM）

3步数stepsNUM..（5）否—

4睡眠sleepNUM..（5）否单位为秒（S）

5温度temperatureNUM..（3,1）是—

6湿度humidityNUM..（3,1）是—

7经纬度longitudeAndLatitudeC..50是当前位置的经纬度信息

8数据包大小packetSizeNUM..（5）是单位为字节（B）

9数据包速率packetRateNUM..（3,2）是单位为兆比特每秒（Mbps）

10报错频率errorRateNUM..（3）是单位为次/秒

11响应码codeC1是1：成功；0：失败

12提示信息messageC..200否—

13电量electricityNUM..（3）是—

14版本versionNUM..（4）是—

身份验证接口

通过应用端验证用户访问权限。

接口地址：https://IP地址:端口/。

接口类型：websocket。

接口名称：AuthLogin。

输入/请求参数：见表6。

输出/返回参数：见表7。

请求示例：见附录A的A.3.1。

5

DB35/T2188—2024

返回示例：见附录A的A.3.2。

表6身份验证接口输入参数表

序号参数名称英文名称数据类型及格式是否必填说明

1设备IDidC32是—

2应用程序密钥appKeyC..13是—

3随机字符串参数nonceC..32是—

4时间timeYYYYMMDDHHmmss是当前时间

5签名signC32是校验签名

表7身份验证接口输出参数表

序号参数名称英文名称数据类型及格式是否必填说明

1设备IDidC32是—

2响应码codeC1是1：成功；0：失败

3提示信息messageC..200否—

4访问令牌accessTokenC..50是使用accessToken进行鉴权

数据应用接口

通过应用端监测用户位置、健康状态、使用区域，以及设置开关机状态、设置温度检测间隔、设置

湿度检测间隔。

接口地址：https://IP地址:端口/。

接口类型：websocket。

接口名称：DataApplication。

输入/请求参数：见表8。

输出/返回参数：见表9。

请求示例：见附录A的A.4.1。

返回示例：见附录A的A.4.2。

表8数据应用接口输入参数表

序号参数名称英文名称数据类型及格式是否必填说明

1设备IDidC32是—

2设备类型deviceTypeC1是1：鞋；2：服饰3：其它

6

DB35/T2188—2024

表9数据应用接口输出参数表

序号参数名称英文名称数据类型及格式是否必填说明

1设备IDidC32是—

2经纬度longitudeAndLatitudeC..50是当前位置的经纬度信息

1：心率太快；2：心率太慢；

3健康状态healthStatusC1是3：温度过高；4：温度过低；

5：湿度过高；6：湿度过低

4所在区域regionC..32是—

5开关机状态onOffStateC1是1：开机状态；2：关机状态

6温度检测间隔temperatureIntervalNUM..（3）是单位为分钟（min）

7湿度检测间隔humidityIntervalNUM..（3）是单位为分钟（min）

8心率检测间隔heartRateIntervalNUM..（3）是单位为分钟（min）

9响应码codeC1是1：成功；0：失败

10提示信息messageC..200否—

7

DB35/T2188—2024

附录A

（资料性）

智能鞋服数据接口参数JSON代码示例

A.1数据采集接口

A.1.1请求示例

{

"id":"12321431232324353233133353233133",

"deviceType":"1",

"beginTime":"2023-08-1114:00:00",

"endTime":"2023-08-1115:00:00"

}

A.1.2响应示例

{

"id":"35323313312321431232324353233133",

"locations":[

{"time":"2023-08-1114:02:23","longitudeAndLatitude":"113.58762,37.86236"},

{"time":"2023-08-1114: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