ICS35.040 CCS L72 TCCUA 中国计算机用户协会团体标准 T/CCUA 042—2024 版本典藏网站资源长期保存服务接口要求 Long-term preservation website resources - Service interface requirement 2024- 12- 16 发布 2025－1－16实施 中国计算机用户协会 发布 T/CCUA 042—2024 目 次 前 II 1 范围 2规范性引用文件 3术语和定义 4缩略语 5技术要求. 5.1通讯协议要求 5.2接口技术类型 5.3性能要求.. 5.4安全性要求 6接口应用类型及要求 6.1访问身份鉴别接口 6.1.1接口要求 6.1.2输入与输出.. 6.2资源对象检索接口 6.2.1接口要求 6.2.2输入与输出 6.3资源对象详情获取接口 6.3.1接口要求. 6.3.2输入与输出， 6.4资源对象提取接口 6.4.1接口要求.. 6.4.2输入与输出， 6.5保存实体检索接口 6.5.1接口要求．.. 6.5.2输入与输出， 6.6保存实体详情获取接口 6.6.1接口要求 6.6.2输入与输出. 6.7网站回放接口 6.7.1接口要求 6.7.2输入与输出. 文 献 T/CCUA 042—2024 前言 本文件按照GB/T1.1一2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定 起草。 本文件由中国计算机用户协会提出并归口。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件起草单位：中国国家版本馆、中国计算机用户协会创新技术应用分会、《全国新书目》杂志 有限责任公司、江苏嘉图网络科技股份有限公司。 本文件主要起草人：刘成勇、王志庚、张琦、吕健泳、张颖，马驰、马腾飞、周长岭。 II T/CCUA 042—2024 版本典藏网站资源长期保存服务接口要求 1范围 本文件规定了版本典藏网站资源长期保存服务接口的技术要求，包括不同种类应用服务接口及输入 输出参数 本文件适用于各类图书馆及相关团体、企事业单位、社会组织从事网站资源长期保存服务接口的开 发建设。 2规范性引用文件 下列文件中的内容通过文中的规范性引用而构成本文件必不可少的条款。其中，注日期的引用文件， 仅该日期对应的版本适用于本文件；不注日期的引用文件，其最新版本（包括所有的修改单）适用于本 文件。 T/CCUA40-2024版本典藏网站资源长期保存核心元数据 RFC 2616超文本传输协议——HTTP/1.1(HypertextTransferProtocol--HTTP/1.1) 3术语和定义 下列术语和定义适用于本文件。 3.1长期 long-term 虑及技术变化（包括支持新载体、新数据格式）和用户群体变化对典藏信息影响的足够长的时间段。 这个时间段延伸到无限未来。 [来源：IS014721:2012，1.7.2有修改] 3.2长期保存long-term preservation 一种可靠的长期维护版本典藏网站资源真实、完整、有效的行为。 [来源：DA/T47—2009，3.3有修改] 3. 3 资源对象实体resource object entity 包含知识对象实体、表现实体和文件实体的数字形式的信息单元。 ［来源：T/CCUA40—2004，3.3] 3. 4 知识对象实体 intellectual entity 聚合在一起的内容单元（或是信息单元） 示例：例如，图书、地图、照片、数据库或软件。 注1：一个知识对象实体可以包含多个二级的知识对象实体 注2：知识对象实体可以有一个或多个数字的表现形式。 L来源：T/CCUA402004，3.4」 3.5 表现实体 representation entity 用于对知识对象实体进行完整而合理再现的一组文件的整体表示。 ［来源：T/CCUA40—2004，3.5] T/CCUA 042—2024 3. 6 文件实体 file entity 用于描述资源文件主要特征的实体。 [来源：T/CCUA40—2004，3.6] 3.7 活动实体activity entity 涉及或影响至少一个资源对象或责任者的行为。 [来源：T/CCUA 40—2004，3.7] 3.8 权利实体 rights entity 属于资源对象与/或责任者的一种或多种权利或许可的声明主张。 [来源：T/CCUA40—2004，3.9] 3. 9 责任者实体 agent entity 长期保存活动中所涉及的个人或组织。包含机构实体和个人实体。 来源：T/CCUA40—2004，3.10] 3.10 软件实体 softwareentity 长期保存活动中所涉及的各种类型的应用软件、系统软件、数据库系统、中间件等软件系统。 L来源：T/CCUA402004，3.13 3.11 环境实体environmententity 长期保存活动中所涉及的各种软件、硬件和网络环境。 [来源：T/CCUA 40—2004，3.14] 3.12 保存实体 preservation entity 长期保存活动中所涉及的实体。包括：资源对象实体、活动实体、权利实体、责任者实体、软件实 体和环境实体。 3.13 网站回放website replay 利用回放技术重新构建并展示保存的网页资源的功能。 3.14 服务接口提供方serviceinterfaceprovider 拥有版本典藏网站资源长期保存系统并通过服务接口方式提供网站资源数据服务的组织或个人。 3.15 服务接口使用方service interfaceconsumer 通过服务接口使用版本典藏网站资源长期保存系统的组织或个人。 4缩略语 2 T/CCUA 042—2024 下列缩略语适用于本文件。 HTTP：超文本传输协议（Hyper Text Transfer Protocol) HTTPS：安全超文本传输协议（HyperTextTransferProtocol Secure） IP：网际互连协议（InternetProtocol） JsoN：Javascript对象标记法（JavaScriptObjectNotation） REST：表述性状态转移（Representational State Transfer） SOAP：简单对象访问协议（SimpleObjectAccessProtocol） XML：可扩展标记语言（ExtensibleMarkupLanguage） 5技术要求 5.1通讯协议要求 通讯传输协议应采用HTTP标准协议或HTTPS标准协议： a) 服务接口采用HTTP标准协议时应采用HTTP1.0或HTTP1.1标准协议； b） 服务接口采用HTTPS协议时，应采用在中华人民共和国境内注册的权威证书认证机构颁发的 SSL 证书。 5.2接口技术类型 版本典藏网站资源长期保存服务接口技术类型应采用REST接口或Webservice接口： a）服务接口采用REST接口时应使用GET或POST方法，返回报文数据格式为JSON格式： b) 服务接口采用Webservice接口时，应采用SOAP1.1或SOAP1.2访问协议，传输数据格式 为XML格式。 XML格式为保证接口数据有效传输，应对接口相关的消息报文中的特殊字符进行转义处理，确保各 服务接口使用方能够成功处理有效的XML报文数据，具体见表1。 表1XML特殊字符转义对应表 序号 转义前 转义后 1 &amp; 2 < &1t; 3 > &gt; 4 “ &quot; 5 &apos; 5.3性能要求 服务接口的响应时间应小于或等于5s。 5.4安全性要求 输入、输出相关数据在传输过程中都应加密。使用HTTPS协议进行通信，确保数据的机密性和完整 性。 6接口应用类型及要求 6.1访问身份鉴别接口 6.1.1接口要求 访问身份鉴别接口用于验证服务接口使用方身份的合法性，只有通过验证才能使用其他访问接口。 接口应符合下列要求： 3 T/CCUA 042—2024 a) 服务接口使用方提供有效的用户名和密码进行身份鉴别，为了提高安全性，接口可以要求使 用多因素认证，如手机验证码等。 b) 当服务接口使用方通过身份鉴别后，系统生成一个访问令牌，服务接口使用方在后续的请求 中携带这个令牌以证明其身份，令牌需要定期更新或刷新，以防止令牌被滥用。 c) 如果验证失败，向服务接口使用方返回明确的出错消息和代码。 6.1.2输入与输出 访问身份鉴别接口的输入输出包括： a）输入包括：用户名和密码以及其他认证因素，如手机验证码等； b）输出包括：验证结果，验证成功输出令牌，验证失败输出出错消息和代码。 6.2资源对象检索接口 6.2.1接口要求 资源对象检索接口用于检索版本典藏网站资源长期保存系统中符合条件的资源对象。资源对象类型 包括：知识对象实体、表现实体、文件实体。 接口应符合下列要求： a) 支持对三类资源对象公开的元数据的检索，检索包括：单词检索、多词检索、通配符检索、 范围检索等。 检索结果中包含命中记录的主要元数据，如资源对象标识符、名称等。 c) 支持对检索结果的特定元数据排序和过滤； 对于检索结果数量多的情形，支持分页返回检索结果，并允许设定返回结果的数量限制。 e） 使用本接口前先获得系统认证和授权，只有经过身份鉴别和授权才能访问和使用该接口。 6.2.2输入与输出 资源对象检索接口的输入输出包括： a）输入包括：资源对象类型、检索词、检索字段、排序、分页等要求； b）输出包括：检索结果数量、命中资源对象的