TY/T 1012-2026 全民健身运动码 应用接口

　　中华人民共和国体育行业标准

　　TY/T 1012—2026

　　全民健身运动码 应用接口

　　Code for national fitness—Application interface

　　2026⁃03⁃16 发布 2026⁃09⁃15 实施

　　国家体育总局 发 布

　　前 言

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

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

　　本文件由国家体育总局群众体育司提出 。

　　本文件由国家体育总局归口 。

　　本文件起草单位：国家体育总局体育信息中心 、力盛云动(上海)体育科技股份有限公司 、佳兆业网络科技(深圳)有限公司 、北京健客体育有限公司 、广州珠江体育文化发展股份有限公司 、北京北奥集团有限责任公司 、西安建筑科技大学 、山东省体育训练中心 、济南市群众体育事业发展中心 、浙江大学 、天津圣智体育科技有限公司 、湖北邮电规划设计有限公司 、联通数字科技有限公司 、橙狮体育有限公司 、中国移动通信集团设计院有限公司 、国体智慧体育技术创新中心(北京)有限公司 、蚂蚁逸康(广州)信息技术有限公司 、上海大学 。

　　本文件主要起草人：刘洛东 、阳琳赟 、李玮 、王志伟 、张蓓 、邓璐 、薛瑞瑾 、李辰 、刘海梦 、吴楠 、苏怡云 、周星星 、赵坤 、马涵 、由文华 、谭晓斗 、刑亮 、胡亮 、张岩 、陈晓静 、张峰 、栾忱忱 、许长敬 、刘海博 、赵聘 、蒋宜辰 、孙岩 。

　　引 言

　　在全民健身国家战略深入实施的背景下 ，群众健身需求日益多元且精细化 ，对全民健身服务的智慧化 、便捷化提出了更高要求 。全民健身运动码作为整合全民健身相关信息与服务的重要载体 ，是推动全民健身智慧化发展的关键抓手 。为进一步规范全民健身运动码的建设与应用，提升全民健身服务水平，满足人民群众对科学健身 、高效参与体育活动的需求 ,制定此标准 。

　　针对全民健身运动码的标准包括：

　　——《全民健身运动码 参考模型》，规定了全民健身运动码的组成结构 、码制和展现形式 、编码规则 、应用流程和应用要求;

　　——《全民健身运动码 数据格式》，规定了全民健身运动码数据的数据结构 、数据元属性 、数据格式和数据管理要求;

　　——《全民健身运动码 应用接口》，规定了全民健身运动码应用接口的服务类型 、接口说明和接口应用 。

　　全民健身运动码 应用接口

　　1 范围

　　本文件规定了全民健身运动码应用接口的服务类型 、接口说明和接口应用 。

　　本文件适用于全民健身运动相关应用系统的设计 、开发和系统集成 。

　　本文件也适用于全民健身运动码数据的收集与交换 。

　　2 规范性引用文件

　　下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款 。其中，注日期的引用文件，仅该日期对应的版本适用于本文件;不注日期的引用文件，其最新版本(包括所有的修改单)适用于本文件 。

　　GB/T 2260 中华人民共和国行政区划代码

　　TY/T 1010—2026 全民健身运动码 参考模型

　　3 术语和定义

　　本文件没有需要界定的术语和定义 。

　　4 服务类型

　　全民健身运动码相关的服务类型说明见表 1。

　　表 1 服务类型说明

　　运动码制码接口中的验证模式说明见表 2。

　　表 2 运动码制码接口中的验证模式说明

　　运动码验码接口中的验证模式说明见表 3。

　　表 3 运动码验码接口中的验证模式说明

　　5 接口说明

　　5.1 概述

　　接口类型及说明见表 4。

　　表 4 接口类型及说明

　　5.2 用户基本信息填报

　　5.2.1 调用方式

　　用户基本信息填报接口应通过互联网或政务外网调用 。

　　5.2.2 参数要求

　　用户基本信息填报接口参数要求见表 5。

　　表 5 用户基本信息填报接口参数要求

　　表 5 用户基本信息填报接口参数要求( 续 )

　　返回数据格式统一采用字符串格式 。

　　示例：

　　5.3 用户运动信息检验

　　5.3.1 调用方式

　　用户运动信息检验接口应通过互联网或政务外网调用 。

　　5.3.2 参数要求

　　用户运动信息检验接口的参数要求见表 6。

　　表 6 用户运动信息检验接口的参数要求

　　返回数据格式统一采用字符串格式 。

　　示例：

　　5.4 运动码调用申请

　　5.4.1 调用方式

　　客户端向服务端发起业务申请，作为后续操作的凭证，应通过互联网或政务外网调用 。

　　5.4.2 参数要求

　　运动码调用申请接口参数要求见表 7。

　　表 7 运动码调用申请接口参数要求

　　返回数据格式统一采用 Json 格式 。

　　示例：

　　5.5 运动码制码请求

　　5.5.1 调用方式

　　运动码制码请求接口应通过互联网或政务外网调用 。

　　5.5.2 参数要求

　　运动码制码请求接口参数要求见表 8。

　　表 8 运动码制码请求接口参数要求

　　返回数据格式统一采用 Json 格式 。

　　示例：

　　5.6 运动码验码请求

　　5.6.1 调用方式

　　运动码验码请求接口应通过互联网或政务外网调用，宜具有离线解码机制 。

　　5.6.2 参数要求

　　运动码验码请求接口参数要求见表 9。

　　表 9 运动码验码请求接口参数要求

　　返回数据格式统一采用 Json 格式 。

　　示例：

　　5.7 用户运动信息纠错

　　5.7.1 调用方式

　　针对运动信息查询页面中的错误信息，用户可发起纠错申请 。用户运动信息纠错接口应通过互联网或政务外网调用 。

　　5.7.2 参数要求

　　用户运动信息纠错接口参数要求见表 10。

　　表 10 用户运动信息纠错接口参数要求

　　返回数据格式统一采用 Json 格式 。

　　示例：

　　6 接口应用

　　6.1 应用模怯

　　6.1.1 具体运动信息管理业务由各地区负责 ，全民健身信息服务平台主要为地方应用服务 ，提供综合的大数据分析比对支撑，为各地区提供运动码标准和相关技术查询接口服务 。

　　6.1.2 各地区可结合本地区数据咨询开发运动码服务，在本地区平台上直接面向组织和个人服务 。

　　6.1.3 各地应负责所辖地的运动码服务的投诉处理 。

　　6.2 对接模怯

　　已建设运动码相关应用的地区，可按照本文件与全民健身信息服务平台对接 。各地区平台应能识别由全民健身信息服务平台生成的运动码，基于全民健身信息服务平台运动码的互联互通 。全民健身信息服务平台提供跨地区个人运动信息查询服务 。

　　附 录 A

　　(资料性)

　　接口返回代码说明

　　用户个人基本信息填报 、用户运动信息检验和用户运动信息纠错等接口的返回值见表 A .1。

　　表 A.1 用户个人信息填报、用户运动信息检验和用户运动信息纠错等接口的返回值

　　运动码调用申请 、运动码制码请求 、运动码验码请求等接口的返回值见表 A .2。

　　表 A.2 运动码调用申请、运动码制码请求、运动码验码请求等接口的返回值

　　———————————