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

ICS01.12035CCSA0035福 建 省 地 方 标 准DB35/T2188—2024海峡两岸共通 智能鞋服数据接口要求Cross-straitintegrateddevelopment—Datainterfacerequirementsofsmartshoesandclothing2024-07-03发布 2024-10-03实施福建省市场监督管理局 发布DB35/T2188—2024目 次前言 II引言 III范围 1规范性引用文件 1术语和定义 1缩略语 1接口框架 1通用要求 2技术要求 3接口设计 4附录A（资料性） 智能鞋服数据接口参数JSON代码示例 8IDB35/T2188—2024前 言本文件按照GB/T1.1—2020《标准化工作导则 第1部分：标准化文件的结构和起草规则》的规起草。请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。本文件由福建奇鹭物联网科技股份公司提出。本文件由福建省信息化标准化技术委员会(SAFJ/TC11)归口。（福建（中国台湾技有限公司。本文件主要起草人：林仪清、庄榕榕、王成、范宗文、缑锦、张惠臻、萧宗志（中国台湾）、林瑶（中国台湾）、方龙祥（中国台湾）、吴楚东。IIDB35/T2188—2024引 言2025推广有着重要意义。智能鞋服数据接口要求的制定有助于推动智能鞋服在数据接口方面的进步及示范推广，促进行业管理水平的进一步提升。IIIDB35/T2188—2024海峡两岸共通 智能鞋服数据接口要求范围本文件规定了海峡两岸智能鞋服数据的接口框架、通用要求、技术要求和接口设计。本文件适用于海峡两岸鞋服行业智能鞋服的数据采集、传输、管理和应用及相关接口设计。规范性引用文件（包括所有的修改单适用于本文件。GB/T7408.1—2023 日期和时间 信息交换表示法 第1部分：基本原则术语和定义下列术语和定义适用于本文件。智能鞋服 smartshoesandclothing能力的穿戴鞋服。注：通常具有多种感知、状态或生理指标监测等功能。缩略语下列缩略语适用于本文件。APP：应用程序（Application）HTTPS：安全超文本传输协议（HypertextTransferProtocolSecure）ID：唯一标识号（Identification）JSON：JavaScript对象表示法（JavaScriptObjectNotation）JWT：JSON网页令牌（JSONWebToken）OPP：对象存储规范（ObjectPushProfile）XML：可扩展标记语言（eXtensibleMarkupLanguage）接口框架智能鞋服的数据接口框架见图1，包含智能鞋服终端、智能鞋服应用、服务端（数据管理、数据处理与计算），以及数据采集接口、状态监测接口、身份验证接口、数据应用接口。1DB35/T2188—2024数据应用接口数据应用接口状态监测接口身份验证接口用户端数据采集接口智能鞋服应用端服务端智能鞋服终端数据管理模块图1 智能鞋服数据接口框架智能鞋服终端采集使用者的相关数据；智能鞋服应用端为用户提供查看位置运动和健康状态可视等反馈和建议；控制管理接口能设置智能鞋服开关机状态、检测间隔等。数据采集接口用于将智能鞋服终端的各类数据传输到智能鞋服应用端，可实时获取智能鞋服使用者的相关数据。状态监测接口用于收集、传输智能鞋服相关状态监测数据。身份验证接口用于验证用户的身份信息，保障合法用户用智能鞋服的功能。数据应用接口用于将服务端的数据分析挖掘结果和智能鞋服的控制信息传输到应用端。通用要求智能鞋服数据接口应满足以下要求：JSON、XMLWebHTTPSOPPJWT鉴权验证；POST接口提供错误处理机制，包括错误代码和错误信息。当出现错误时，返回相应的错误提示；数据交换接口具备互操作性；接口具备可扩展性；1。2DB35/T2188—2024表1 数据类型及格式说明表序号数据类型数据格式说明1字符型以大写字母“C”代表字符型：CX：表示定长为“X”的字符型数据元值；C..X：表示最长为“X”C..ul：表示长度不确定的字符型数据元值一切能显示打印的字具有计算能力2数值型以大写字母“NUM”代表数值型：NUM..（X：表示最长为“X”的数值型数据元值；NUM..（X,y：表示总长度为“X”位、其中小数点后为位的数值型数据元值进行数学运算的数据3日期时间型YYYYMMDD：表示YYYY年MM月DD日的日期格式；YYYYMMDDHHmmss：表示YYYY年MM月DD日mm分ss秒的时间格式采用GB/T7408.1—2023的规定用以表示日期及时间的数据技术要求数据采集接口数据采集接口应满足以下要求：求添加其他字段；更新；其他静态信息宜定期更新。状态监测接口含通讯/传输状态监测、报错频率/状态监测。状态监测接口满足以下要求：心率监测：监测用户的心率数据，包括心率变化、心率异常等；步数监测：监测用户的步行数据，包括步数、睡眠-活动关联等；睡眠监测：监测用户的睡眠质量，包括睡眠时间、深睡时间、浅睡时间等；温度监测：监测智能鞋服穿戴温度数据；湿度监测：监测智能鞋服穿戴湿度数据；位置监测：监测用户的位置及行走路线；通讯/传输状态监测：监测数据包的大小、速率；报错频率/状态监测：监测报错频率/状态。身份验证接口身份验证接口的内容包括但不限于：SM2牌，以取得相应的接口数据请求权限；验证结果接口：身份验证结果返回。3DB35/T2188—2024数据应用接口数据应用接口的内容包括但不限于：数据处理与分析的接口包括用户位置监测、健康状态监测、智能鞋服使用区域等分析应用；间隔等。接口设计数据采集接口通过硬件设备采集信息。接口地址：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）4DB35/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。5DB35/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：其它6DB35/T2188—2024表9 数据应用接口输出参数表序号参数名称英文名称数据类型及格式是否必填说明1设备IDidC32是—2经纬度longitudeAndLatitudeC..50是当前位置的经纬度信息3健康状态healthStatusC1是1：心率太快；2：心率太慢；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否—7DB35/T2188—2024附 录 A（资料性）智能鞋服数据接口参数JSON代码示例请求示例{"id":"12321431232324353233133353233133","deviceType":"1","beginTime":"2023-08-1114:00:00","endTime":"2023-08-1115:00:00"}响应示例{"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"}请求示例{"id":"35323313312321431232324353233123","deviceType":"1"}8DB35/T2188—2024响应示例{"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