《国民体质监测数据接口要求.》

ICS97.220.01

CCSY55

CSSS

中国体育科学学会团体标准

T/CSSSXXXX—XXXX

国民体质监测数据接口要求

Datainterfacerequirementsofnationalphysicalfitnesssurveillance

（征求意见稿）

在提交反馈意见时，请将您知道的相关专利连同支持性文件一并附上。

XXXX-XX-XX发布XXXX-XX-XX实施

中国体育科学学会发布

T/CSSSXXXX—XXXX

国民体质监测数据接口要求

1范围

本文件确立了国家国民体质监测数据接口的应用原则，规定了国家国民体质监测数据接口的基本

要求、数据类型和接入要求。

本文件适用于3-6岁幼儿、20-59岁成年人、60-79老年人的国民体质监测数据接口的设计、开发和应

用。

2规范性引用文件

本文件没有规范性引用文件。

3术语、定义和缩略语

3.1术语和定义

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

3.1.1

国民体质监测nationalphysicalfitnesssurveillance

国家为系统掌握国民体质状况，以抽样调查的方式，按照国家发布的国民体质监测指标，在全国

范围内定期对监测对象进行统一测试和对监测数据进行分析研究工作。

3.1.2

国家国民体质监测工作数据采集与质量控制平台nationalphysicalfitnesssurveillancedatacollection

andqualitycontrolplatform

用于高效收集、整理和存储国民的体质监测数据的平台。

3.2缩略语

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

ACL：访问控制列表(AccessControlList)

API:应用程序编程接口（ApplicationProgrammingInterface）

HTTPS：超文本传输安全协议(HyperTextTransferProtocolSecure)

JSON：数据交换格式(JavaScriptObjectNotation)

REST:表述性状态转移(RepresentationalStateTransfer)

UTF-8：用于表示Unicode的可变长度字符编码(UnicodeTransformationFormat-8)

XML：可扩展标记语言(eXtensibleMarkupLanguage)

4应用原则

4.1信息安全性

4.1.1保密性：数据接口应确保数据在传输过程中的保护。

4.1.2完整性：保证数据在创建、存储、处理及上输过程信息准确和一致。

4.1.3抗抵赖性：通过增加时间戳来实施抵赖证据。

4.1.4可核查性：接口操作应具备日志记录功能，便于追踪数据流动的全过程、故障排查和审计。

4.2兼容性

4

T/CSSSXXXX—XXXX

接口设计方案应着重确保与全国各地级市体质监测系统的兼容，不论是任何操作系统或任一版

本，都能实现与国家国民体质监测数据采集及质量管控中枢平台之间的联系与数据流通。

4.3可靠性

数据接口应设计有高可靠性机制，确保数据传输的完整性和服务的稳定性。

4.4高效性

接口设计应优化数据处理和传输效率，减少延迟，确保在满足安全性和兼容性的前提下，能够高

效地完成数据交换。

4.5有效性

数据接口应确保所传输的数据是有效准确的，包括但不限于验证数据内容和格式的完整性、逻辑一

致性等，防止无效或错误的数据被处理和存储。接口设计应集成数据验证机制，严格校验输入输出，确

保数据格式及业务规则相符，提升数据处理质量和分析准确性。

5接口基本要求

5.1传输协议

所有数据应通过HTTPS协议进行传输。

5.2认证与授权

5.2.1访问控制:实现严格的访问控制列表(ACL)和角色权限管理，仅允许经过API密钥认证的用户

访问。

5.2.2密钥更新:定期更新用户API密钥，减少被未经授权的访问或攻击的风险。

5.3数据传输

测试数据条分为实时传输和批量传输，实时传输在软件采集数据后自动传输到国家国民体质监测

工作数据采集与质量控制平台，批量传输应在有条件后手动选择数据测试日期后传输到国家国民体质

监测工作数据采集与质量控制平台。

5.4兼容格式

5.4.1REST架构：按照REST架构风格来设计网络应用的API。

5.4.2数据格式：默认使用JSON，支持XML作为可选项。

5.4.3版本控制：当前版本v1.0，新版本发布时，v1.0应至少支持一年。

5.5存储与传输机制

5.5.1错误处理：明确错误消息格式，便于调用者理解错误原因并采取相应措施。

5.5.2存储策略：利用数据库管理系统进行数据存储。

5.5.3日志记录：记录每条请求的详细信息，应至少保存1年。

6接口数据类型

接口数据类型见表1，接口数据类型的具体要求见附录A。

表1接口数据类型

数据类型分类具体参数

设备信息设备定位信息

身份证号、姓名、性别、民族、年龄、出生日期、测试年龄、家庭住址、城乡种类、所属机

个人信息构、机构代码、注册日期、修改日期、测试日期、文化程度、电话手机号、行业、职称、职

业

5

T/CSSSXXXX—XXXX

数据类型分类具体参数

身高、坐高、体重、胸围、体脂肪量、去脂体重、无机盐、蛋白质、肌肉总量、身体总水

分、细胞内液、细胞外液、身体质量指数（bodymassindex，BMI）、骨骼肌、腰臀比、脂

肪率、水肿系数、左上肢肌肉量、右上肢肌肉量、躯干肌肉量、左下肢肌肉量、右下肢肌肉

幼儿指标(3-6岁)量、左上肢脂肪量、右上肢脂肪量、躯干脂肪量、左下肢脂肪量、右下肢脂肪量、八频段

（1khz、5khz、20khz、50khz、100khz、250khz、500khz、1000khz）下的生物总阻抗和节

段阻抗、基础代谢、身体年龄、安静脉搏、握力、纵跳、立定跳远、坐位体前屈、双脚连续

跳、15m绕障碍跑、走平衡木

身高、体重、腰围、臀围、脉搏、体脂肪量、去脂体重、无机盐、蛋白质、肌肉总量、身体

总水分、细胞内液、细胞外液、BMI、骨骼肌、腰臀比、脂肪率、水肿系数、左上肢肌肉

量、右上肢肌肉量、躯干肌肉量、左下肢肌肉量、右下肢肌肉量、左上肢脂肪量、右上肢脂

成年人指标(20-59岁)肪量、躯干脂肪量、左下肢脂肪量、右下肢脂肪量、八频段（1khz、5khz、20khz、50khz、

100khz、250khz、500khz、1000khz）下的生物总阻抗和节段阻抗、基础代谢、身体年龄、

收缩压、舒张压、肺活量、心肺耐力、安静心率、功率、15个运动中心率，握力、背力、纵

跳、俯卧撑、跪卧撑、1min仰卧起坐、坐位体前屈、闭眼单脚站、选择反应时

身高、体重、腰围、臀围、脉搏、体脂肪量、去脂体重、无机盐、蛋白质、肌肉总量、身体

总水分、细胞内液、细胞外液、BMI、骨骼肌、腰臀比、脂肪率、水肿系数、左上肢肌肉量、

右上肢肌肉量、躯干肌肉量、左下肢肌肉量、右下肢肌肉量、左上肢脂肪量、右上肢脂肪量、

老年人指标(60-79岁)躯干脂肪量、左下肢脂肪量、右下肢脂肪量、八频段（1khz、5khz、20khz、50khz、100khz、

250khz、500khz、1000khz）下的生物总阻抗和节段阻抗、基础代谢、身体年龄、收缩压、舒

张压、肺活量、2min原地高抬腿、握力、30s坐站测试仪、坐位体前屈、闭眼单脚站、选择

反应时

备用字段—

7接口接入要求

7.1接口调用方式

数据上传方应按如下顺序调用接口上传相关数据：

a)数据上传方向国家国民体质监测工作数据采集与质量控制平台申请接入账号client_id、加密密

钥secret_key；

b)数据上传方通过接入账号client_id的加密秘钥，上传数据；

c)数据中的测试项目（如身高、体重、肺活量）添加GPS，确保数据的真实有效性。

7.2字符编码

服务接口参数和返回结果统一采用UTF-8字符集。

7.3报文格式

7.3.1请求报文

请求报文为POST方法，POST方法报文头为：Content-Type:application/x-www-form-urlencoded;cha

rset=UTF-8。

7.3.2响应报文

响应报文数据格式为JSON格式，响应报文头为：Content-Type:application/json;charset=UTF-8。

7.4接口参数

7.4.1请求参数

接口请求时的请求参数见表2。

表2请求参数

6

T/CSSSXXXX—XXXX

请求参数参数类型是否必需说明

1.请求参数为JSON格式字符串，见附录A。格式

可参考：

[

{参数1:””,参数2:””,参数3:””},

ParamsString是...

...

]

2.请求参数需进行加密传输，数据token验证示例见

附录B

1.MD5字符串；

tokenString是2.由国家国民体质监测工作数据采集与质量控制平台

生成

7.4.2请求注意事项

请求注意事项包括但不限于：

a)软件版本不符合的数据不予接收；

b)token不符的数据不予接收；

c)参数解密异常数据不予接收；

d)参数值异常数据不予保存；

e)GPS校验不符的数据不予接收。

7.4.3返回参数

接口请求成功后，返回参数见表3：

表3返回参数

请求参数参数类型说明

successBoolean接口的执行结果

messageString成功或错误描述信息

示例：

{

“success”:true

“message”:”接口调用成功”

}

A

A

B

7

T/CSSSXXXX—XXXX

B

C

附录A

（规范性）

接口数据类型具体要求

接口数据类型具体要求见表A.1。

表A.1接口数据类型具体要求

参数名称参数类型参数范围是否必填说明

姓名String50个字节必填

性别String5个字节必填男或女

出生日期String50个字节必填日期格式：yyyy-MM-dd

年龄Double5个字节必填成人，老年为整岁，幼儿为0.5岁一个级别

身份证号String20个字节必填（唯一识别id）

民族String20个字节必填例如：汉族、壮族、满族

家庭住址String200个字节非必填

注册日期String50个字节非必填会员信息注册日期

修改日期String50个字节非必填会员信息的修改日期

工作单位String200个字节非必填

职称String50个字节非必填

职业String50个字节非必填

行业String50个字节非必填

城乡种类String50个字节必填如:城镇体力劳动者,城镇非体力劳动者

文化程度String50个字节非必填

电话手机号String20个字节非必填

机构名称String200个字节必填

机构代码String200个字节必填由12位省市区县街道代码加2位检测站点的区别码

根据当天测试日期计算出测试年龄，幼儿以半岁计算。（精

测试年龄Double5个字节必填

确到小数点后一位）

测试日期String50个字节必填日期格式：yyyy-MM-dd

身高Double50个字节非必填（精确到小数点后一位）

身高评分Int5个字节非必填只幼儿参与评分

身高评价String5个字节非必填只幼儿参与评价

身高测试具

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

体日期

身高GPSString50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

坐高Double5个字节非必填只幼儿测试项目(精确到小数点后一位)

坐高评分Int5个字节非必填只幼儿测试项目

坐高评价String5个字节非必填只幼儿测试项目

坐高测试具

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

体日期

坐高GPSString50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

体重Double5个字节非必填(精确到小数点后一位)

体重测试具

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

体日期

体重指数Double5个字节非必填(精确到小数点后一位)

体重指数评

Int5个字节非必填

分

体重指数权

Double5个字节非必填(精确到小数点后两位)

重评分

体重指数评

String5个字节非必填

价

体重指数测

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

试具体日期

8

T/CSSSXXXX—XXXX

参数名称参数类型参数范围是否必填说明

体重指数

String50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

GPS

体脂率Double5个字节非必填（精确到小数点后一位）

体脂率评分Int5个字节非必填

体脂率权重

Double5个字节非必填（精确到小数点后两位）

评分

体脂率评价StringString非必填

体脂率测试

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

具体日期

体脂率GPSString50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

胸围Double5个字节非必填幼儿测试项目(精确到小数点后一位)

胸围评分Int5个字节非必填幼儿测试项目

胸围评价String5个字节非必填幼儿测试项目

胸围测试具

String50个字节非必填幼儿测试项目日期格式：yyyy-MM-ddHH:mm

体日期

胸围GPSString50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

腰围Double5个字节非必填（精确到小数点后一位）

腰围评分Int5个字节非必填

腰围评价String5个字节非必填

腰围测试具

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

体日期

腰围GPSString50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

臀围Double5个字节非必填（精确到小数点后一位）

臀围评分Int5个字节非必填

臀围评价String5个字节非必填

臀围测试具

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

体日期

臀围GPSString50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

肺活量Int5个字节非必填

肺活量评分Int5个字节非必填

肺活量权重

Double5个字节非必填（精确到小数点后两位）

评分

肺活量评价String5个字节非必填

肺活量测试

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

具体日期

肺活量GPSString50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

功率车二级

Double5个字节非必填（精确到小数点后一位）

负荷试验

功率车二级

负荷试验评Int5个字节非必填

分

功率车二级

负荷试验权Double5个字节非必填（精确到小数点后两位）

重评分

功率车二级

负荷试验评String5个字节非必填

价

功率车二级

负荷试验测String50个字节非必填日期格式：yyyy-MM-ddHH:mm

试具体日期

功率车二级

负荷试验String50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

GPS

两分钟原地

Int5个字节非必填

高抬腿

9

T/CSSSXXXX—XXXX

参数名称参数类型参数范围是否必填说明

两分钟原地

Int5个字节非必填

高抬腿评分

两分钟原地

高抬腿权重Double5个字节非必填（精确到小数点后两位）

评分

两分钟原地

StringString非必填

高抬腿评价

两分钟原地

高抬腿测试String50个字节非必填日期格式：yyyy-MM-ddHH:mm

具体日期

两分钟原地

String50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

高抬腿GPS

两分钟原地

Int5个字节非必填

高抬腿_左腿

两分钟原地

高抬腿_左腿

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

测试具体日

期

两分钟原地

高抬腿_左腿String50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

GPS

两分钟原地

Int5个字节非必填

高抬腿_右腿

两分钟原地

高抬腿_右腿

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

测试具体日

期

两分钟原地

高抬腿_右腿String50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

GPS

安静心率Int5个字节非必填幼儿测试项目

安静心率测

String50个字节非必填幼儿测试项目

试具体日期

安静心率

String50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

GPS

握力Double5个字节非必填（精确到小数点后一位）

握力评分Int5个字节非必填

握力权重评

Double5个字节非必填（精确到小数点后两位）

分

握力评价String5个字节非必填

握力测试具

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

体日期

握力GPSString50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

纵跳Double5个字节非必填（精确到小数点后一位）

纵跳评分Int5个字节非必填

纵跳权重评

Double5个字节非必填（精确到小数点后两位）

分

纵跳评价String5个字节非必填

纵跳测试具

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

体日期

纵跳GPSString50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

俯卧撑Int5个字节非必填

俯卧撑评分Int5个字节非必填

俯卧撑权重

Double5个字节非必填（精确到小数点后两位）

评分

10

T/CSSSXXXX—XXXX

参数名称参数类型参数范围是否必填说明

俯卧撑评价String5个字节非必填

俯卧撑测试

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

具体日期

俯卧撑GPSString50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

跪卧撑Int5个字节非必填

跪卧撑评分Int5个字节非必填

跪卧撑权重

Double5个字节非必填（精确到小数点后两位）

评分

跪卧撑评价String5个字节非必填

跪卧撑测试

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

具体日期

跪卧撑GPSString50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

一分钟仰卧

Int5个字节非必填

起坐

一分钟仰卧

Int5个字节非必填

起坐评分

一分钟仰卧

起坐权重评Double5个字节非必填（精确到小数点后两位）

分

一分钟仰卧

String5个字节非必填

起坐评价

一分钟仰卧

起坐测试具String50个字节非必填日期格式：yyyy-MM-ddHH:mm

体日期

一分钟仰卧

String50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

起坐GPS

坐位体前屈Double5个字节非必填（精确到小数点后一位）

坐位体前屈

Int5个字节非必填

评分

坐位体前屈

Double5个字节非必填（精确到小数点后两位）

权重评分

坐位体前屈

String5个字节非必填

评价

坐位体前屈

测试具体日String50个字节非必填日期格式：yyyy-MM-ddHH:mm

期

坐位体前屈

String50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

GPS

闭眼单脚站Double5个字节非必填（精确到小数点后一位）

闭眼单脚站

Int5个字节非必填

评分

闭眼单脚站

Double5个字节非必填（精确到小数点后两位）

权重评分

闭眼单脚站

String5个字节非必填

评价

闭眼单脚站

测试具体日String50个字节非必填日期格式：yyyy-MM-ddHH:mm

期

闭眼单脚站

String50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

GPS

选择反应时Double5个字节非必填（精确到小数点后两位）

选择反应时

Int5个字节非必填

评分

选择反应时

Double5个字节非必填（精确到小数点后两位）

权重评分

11

T/CSSSXXXX—XXXX

参数名称参数类型参数范围是否必填说明

选择反应时

String5个字节非必填

评价

选择反应时

测试具体日String50个字节非必填日期格式：yyyy-MM-ddHH:mm

期

选择反应时

String50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

GPS

背力Int5个字节非必填

背力评分Int5个字节非必填

背力评价String5个字节非必填

背力测试具

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

体日期

背力GPSString50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

30秒坐站Int5个字节非必填

30秒坐站评

Int5个字节非必填

分

30秒坐站权

Double5个字节非必填（精确到小数点后两位）

重评分

30秒坐站评

String5个字节非必填

价

30秒坐站测

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

试具体日期

30秒坐站

String50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

GPS

立定跳远Int5个字节非必填幼儿测试项目

立定跳远评

Int5个字节非必填

分

立定跳远权

Double5个字节非必填（精确到小数点后两位）

重评分

立定跳远评

String5个字节非必填

价

立定跳远测

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

试具体日期

立定跳远

String50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

GPS

双脚连续跳Double5个字节非必填（精确到小数点后一位）

双脚连续跳

Int5个字节非必填

评分

双脚连续跳

Double5个字节非必填（精确到小数点后两位）

权重评分

双脚连续跳

String5个字节非必填

评价

双脚连续跳

测试具体日String50个字节非必填日期格式：yyyy-MM-ddHH:mm

期

双脚连续跳

String50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

GPS

15米绕障碍

Double5个字节非必填（精确到小数点后一位）

跑

15米绕障碍

Int5个字节非必填

跑评分

15米绕障碍

Double5个字节非必填（精确到小数点后两位）

跑权重评分

15米绕障碍

String5个字节非必填

跑评价

12

T/CSSSXXXX—XXXX

参数名称参数类型参数范围是否必填说明

15米绕障碍

跑测试具体String50个字节非必填日期格式：yyyy-MM-ddHH:mm

日期

15米绕障碍

String50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

跑GPS

走平衡木Double5个字节非必填（精确到小数点后一位）

走平衡木是

String5个字节非必填1为挪步横走，0为正常

否挪步横走

走平衡木评

Int5个字节非必填

分

走平衡木权

Double5个字节非必填（精确到小数点后两位）

重评分

走平衡木评

String5个字节非必填

价

走平衡木测

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

试具体日期

走平衡木

String50个字节非必填例如：39.731,116.568（保留小数点后三位精准度）

GPS

国民体质综

Double5个字节非必填（精确到小数点后一位）

合评分

国民体质综

String5个字节非必填

合评价

功率车梅脱

Double5个字节非必填（精确到小数点后两位）

值

功率车最大

摄氧量的相Double5个字节非必填（精确到小数点后两位）

对值

功率车最大

摄氧量的绝Double5个字节非必填（精确到小数点后两位）

对值

15个功率车

String200个字节非必填90,85,90,96,105,112,106,111,0,0,0,0,0,0,0

心率。

功率车测试

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

具体日期

血压计心率Int5个字节非必填

血压计舒张

Int5个字节非必填

压

血压计收缩

Int5个字节非必填

压

血压计测试

String50个字节非必填日期格式：yyyy-MM-ddHH:mm

具体日期

体脂率测试

具体日期

（以下为体String50个字节非必填日期格式：yyyy-MM-ddHH:mm

脂率测试数

据）

去脂体重的

实测值（千Double5个字节非必填（精确到小数点后一位）

克）

体脂肪量的

实测值（千Double5个字节非必填（精确到小数点后一位）

克）

身体肌肉量

的实测值Double5个字节非必填（精确到小数点后一位）

（千克）

13

T/CSSSXXXX—XXXX

参数名称参数类型参数范围是否必填说明

骨骼肌肉的

实测值（千Double5个字节非必填（精确到小数点后一位）

克）

身体总水分

的实测值Double5个字节非必填（精确到小数点后一位）

（千克）

蛋白质的实

测值（千Double5个字节非必填（精确到小数点后一位）

克）

无机盐的实

测值（千Double5个字节非必填（精确到小数点后一位）

克）

细胞外液的

实测值（千Double5个字节非必填（精确到小数点后一位）

克）

细胞内液的

实测值（千Double5个字节非必填（精确到小数点后一位）

克）

左上肢肌肉

量的实测值Double5个字节