ICS35.040

CCSL72

CCUA

中國計算機用戶協(xié)會團體標(biāo)準(zhǔn)

T/CCUAXXXX—XXXX

版本典藏網(wǎng)站資源長期保存服務(wù)接口要求

Long-termpreservationwebsiteresourcesServiceinterfacerequirement

（征求意見稿）

（本草案完成時間：2024-6-18）

在提交反饋意見時，請將您知道的相關(guān)專利連同支持性文件一并附上。

XXXX-XX-XX發(fā)布XXXX-XX-XX實施

中國計算機用戶協(xié)會發(fā)布

T/CCUAXXXX—XXXX

版本典藏網(wǎng)站資源長期保存服務(wù)接口要求

1范圍

本文件規(guī)定了版本典藏網(wǎng)站資源長期保存服務(wù)接口的基本要求、技術(shù)要求和接口要求，界定了有關(guān)

的術(shù)語和定義。

本文件適用于各類圖書館、團體、企事業(yè)單位、社會組織從事網(wǎng)站資源長期保存服務(wù)接口的開發(fā)、

管理等活動。

2規(guī)范性引用文件

下列文件中的內(nèi)容通過文中的規(guī)范性引用而構(gòu)成本文件必不可少的條款。其中，注日期的引用文件，

僅該日期對應(yīng)的版本適用于本文件；不注日期的引用文件，其最新版本（包括所有的修改單）適用于本

文件。

T/CCUAAAAA-XXXXX版本典藏網(wǎng)站資源長期保存核心元數(shù)據(jù)

RFC2616超文本傳輸協(xié)議一HTTP/1.l(HypertextTransferProtocol-一HTTP/1.l)

3術(shù)語和定義

下列術(shù)語和定義適用于本文件。

3.1長期long-term

慮及技術(shù)變化（包括支持新載體、新數(shù)據(jù)格式）和用戶群體變化對典藏信息影響的足夠長的時間段。

這個時間段延伸到無限未來。

[ISO14721:2012定義1.7.2]

3.2長期保存long-termpreservation

一種可靠的長期維護版本典藏網(wǎng)站資源真實、完整、有效的行為。

注：改寫DA/T47—20093.3

3.3

資源對象實體resourceobjectentity

一個數(shù)字形式的信息單元，包含三個子類：知識對象實體、表現(xiàn)實體和文件實體。

[T/CCUAXXX—2004術(shù)語和定義3.3]

3.4

知識對象實體intellectualentity

一個聚合在一起的內(nèi)容單元（或是信息單元），例如，圖書、地圖、照片、數(shù)據(jù)庫或軟件。一個知

識對象實體可以包含多個二級的知識對象實體。一個知識對象實體可以有一個或多個數(shù)字的表現(xiàn)形式。

[T/CCUAXXX—2004術(shù)語和定義3.4]

3.5

表現(xiàn)實體representationentity

用于對知識對象實體進行完整而合理再現(xiàn)的一組文件的整體表示。

[T/CCUAXXX—2004術(shù)語和定義3.5]

3.6

文件實體fileentity

用于描述資源文件主要特征的實體。

1

T/CCUAXXXX—XXXX

[T/CCUAXXX—2004術(shù)語和定義3.6]

3.7

活動實體activityentity

涉及或影響至少一個資源對象或責(zé)任者的行為。

[T/CCUAXXX—2004術(shù)語和定義3.7]

3.8

權(quán)利實體rightsentity

屬于資源對象與/或責(zé)任者的一種或多種權(quán)利或許可的聲明主張。

[T/CCUAXXX—2004術(shù)語和定義3.9]

3.9

責(zé)任者實體agententity

長期保存活動中所涉及的個人或組織。包括兩個子類：機構(gòu)實體和個人實體。

[T/CCUAXXX—2004術(shù)語和定義3.10]

3.10

軟件實體softwareentity

長期保存活動中所涉及的各種類型的應(yīng)用軟件、系統(tǒng)軟件、中間件等軟件系統(tǒng)。

[T/CCUAXXX—2004術(shù)語和定義3.13]

3.11

環(huán)境實體environmententity

長期保存活動中所涉及的各種應(yīng)用軟件、系統(tǒng)軟件、中間件等軟件系統(tǒng)、硬件和網(wǎng)絡(luò)環(huán)境。

[T/CCUAXXX—2004術(shù)語和定義3.14]

3.12

服務(wù)接口提供方serviceinterfaceprovider

擁有版本典藏網(wǎng)站資源長期保存系統(tǒng)并通過服務(wù)接口方式提供網(wǎng)站資源數(shù)據(jù)服務(wù)的組織或個人。

3.13

服務(wù)接口使用方serviceinterfaceconsumer

通過服務(wù)接口使用版本典藏網(wǎng)站資源長期保存系統(tǒng)的組織或個人。

4縮略語

下列縮略語適用于本文件。

HTTP：超文本傳輸協(xié)議（HyperTextTransferProtocol）

HTTPS：安全超文本傳輸協(xié)議（HyperTextTransferProtocolSecure）

REST：表述性狀態(tài)轉(zhuǎn)移（RepresentationalStateTransfer）

XML：可擴展置標(biāo)語言（ExtensibleMarkupLanguage）

JSON：Javascript對象標(biāo)記法（JavaScriptObjectNotation）

IP：網(wǎng)際互連協(xié)議（InternetProtocol）

SOAP：簡單對象訪問協(xié)議（SimpleObject

5技術(shù)要求

5.1通訊協(xié)議要求

2

T/CCUAXXXX—XXXX

通訊傳輸協(xié)議應(yīng)采用HTTP標(biāo)準(zhǔn)協(xié)議或HTTPS標(biāo)準(zhǔn)協(xié)議：

a)服務(wù)接口采用HTTP標(biāo)準(zhǔn)協(xié)議時應(yīng)采用HTTP1.0或HTTP1.1標(biāo)準(zhǔn)協(xié)議；

b)服務(wù)接口采用HTTPS協(xié)議時，應(yīng)采用在中國境內(nèi)注冊的權(quán)威證書認(rèn)證機構(gòu)頒發(fā)的SSL證書。

5.2接口技術(shù)類型

版本典藏網(wǎng)站資源長期保存服務(wù)接口技術(shù)類型應(yīng)采用REST接口或Webservice接口：

a)服務(wù)接口采用REST接口時應(yīng)使用GET或POST方法，返回報文數(shù)據(jù)格式為JSON格式；

b)服務(wù)接口采用Webservice接口時，應(yīng)采用SOAP1.1或SOAP1.2訪問協(xié)議，傳輸數(shù)據(jù)格式

為XML格式。

XML格式為保證接口數(shù)據(jù)有效傳輸，應(yīng)對接口相關(guān)的消息報文中的特殊字符進行轉(zhuǎn)義處理，確保各

服務(wù)接口使用方能夠成功處理有效的XML報文數(shù)據(jù)，具體見表1所示。

表1特殊字符轉(zhuǎn)義對應(yīng)表

序號轉(zhuǎn)義前轉(zhuǎn)義后

1&&

2<<

3>>

4“"

5''

5.3性能要求

服務(wù)接口的響應(yīng)時間應(yīng)小于或等于5s。

輸入、輸出相關(guān)數(shù)據(jù)在傳輸過程中都應(yīng)加密。使用HTTPS協(xié)議進行通信，確保數(shù)據(jù)的機密性和完整

性。

5.4對象實體

本文件涉及的實體均出自T/CCUAXXX-2024。

6接口要求

6.1訪問身份驗證接口

6.1.1接口要求

訪問身份驗證接口用于驗證服務(wù)接口使用方身份的合法性，只有通過驗證才能使用其他訪問接口。

接口要求包括：

a)服務(wù)接口使用方必須提供有效的用戶名和密碼進行身份驗證，為了提高安全性，接口可以要

求使用多因素認(rèn)證，如手機驗證碼等；

b)當(dāng)服務(wù)接口使用方通過身份驗證后，系統(tǒng)應(yīng)生成一個訪問令牌，服務(wù)接口使用方在后續(xù)的請

求中必須攜帶這個令牌以證明其身份，令牌需要定期更新或刷新，以防止令牌被濫用；

c)如果驗證失敗，應(yīng)向服務(wù)接口使用方返回明確的出錯消息和代碼；

d)接口將記錄所有身份驗證相關(guān)的活動，包括成功的登錄、失敗的嘗試、令牌的生成和銷毀等。

6.1.2輸入與輸出

a)輸入包括：用戶名和密碼以及其他認(rèn)證因素，如手機驗證碼等；

b)輸出包括：驗證結(jié)果，驗證成功輸出令牌，驗證失敗輸出出錯消息和代碼。

6.2資源對象檢索接口

6.2.1接口要求

3

T/CCUAXXXX—XXXX

資源對象檢索接口用于檢索版本典藏網(wǎng)站資源長期保存系統(tǒng)中符合條件的資源對象。資源對象包括

三種：知識對象實體、表現(xiàn)實體、文件實體。

接口要求包括：

a)應(yīng)支持對三種資源對象公開的元數(shù)據(jù)的檢索，檢索包括：單詞檢索、多詞檢索、通配符檢索、

范圍檢索等；

b)檢索結(jié)果中應(yīng)包含命中記錄的主要元數(shù)據(jù)，如對象類別、標(biāo)識符、名稱等；

c)應(yīng)支持對檢索結(jié)果的特定元數(shù)據(jù)排序和過濾；

d)對于大量結(jié)果的檢索，接口應(yīng)支持分頁顯示，并允許設(shè)定返回結(jié)果的數(shù)量限制；

e)使用本接口前應(yīng)獲得系統(tǒng)認(rèn)證和授權(quán)，只有經(jīng)過身份驗證和授權(quán)才能訪問和使用接口。

6.2.2輸入與輸出

a)輸入包括：資源對象、檢索詞、檢索字段、分頁要求；

b)輸出包括：結(jié)果數(shù)量、命中資源對象的主要元數(shù)據(jù)。

6.3資源對象詳情獲取接口

6.3.1接口要求

資源對象詳情獲取接口用于獲取版本典藏網(wǎng)站資源長期保存系統(tǒng)中某個特定資源對象的詳細(xì)信息。

資源對象包括三種：知識對象實體、表現(xiàn)實體、文件實體。

接口要求包括：

a)輸入?yún)?shù)中應(yīng)含有能唯一確定某個資源對象的標(biāo)識符；

b)接口返回的詳細(xì)信息應(yīng)以結(jié)構(gòu)化的數(shù)據(jù)格式提供；

c)如果輸入對象的標(biāo)識符無法獲取到詳情，應(yīng)向服務(wù)接口使用方返回明確的出錯消息和代碼；

d)使用本接口前應(yīng)獲得系統(tǒng)認(rèn)證和授權(quán)，只有經(jīng)過身份驗證和授權(quán)才能訪問和使用接口。

6.3.2輸入與輸出

a)輸入包括：資源對象、標(biāo)識符；

b)輸出包括：如命中則輸出資源對象詳細(xì)元數(shù)據(jù)，否則輸出出錯消息和代碼。

6.4資源對象提取接口

6.4.1接口要求

資源對象提取接口用于從版本典藏網(wǎng)站資源長期保存系統(tǒng)中提取特定資源對象的數(shù)據(jù)。資源對象包

括兩種：知識對象實體、表現(xiàn)實體、文件實體。

接口要求包括：

a)輸入?yún)?shù)中應(yīng)含有能唯一確定某個資源對象的標(biāo)識符；

b)應(yīng)能夠穩(wěn)定、高效地連接到數(shù)據(jù)源，如數(shù)據(jù)庫、文件系統(tǒng)、API；

c)應(yīng)清晰地定義如何從數(shù)據(jù)源中提取資源對象；

d)應(yīng)能夠妥善處理各種錯誤情況，如數(shù)據(jù)源連接失敗、數(shù)據(jù)格式錯誤等；

e)應(yīng)提供適當(dāng)?shù)娜蒎e機制，如重試、回退、斷點續(xù)傳等；

f)使用本接口前應(yīng)獲得系統(tǒng)認(rèn)證和授權(quán)，只有經(jīng)過身份驗證和授權(quán)才能訪問和使用接口。

6.4.2輸入與輸出

a)輸入包括：資源對象、標(biāo)識符；

b)輸出包括：資源對象或下載資源對象的地址。

6.5保存實體檢索接口

6.5.1接口要求

保存實體檢索接口用于檢索版本典藏網(wǎng)站資源長期保存系統(tǒng)中符合條件的實體對象。實體對象包括：

資源對象實體、活動實體、權(quán)利實體、責(zé)任者實體、軟件實體和環(huán)境實體。

接口要求包括：

4

T/CCUAXXXX—XXXX

a)應(yīng)支持對各類保存實體對象的公開元數(shù)據(jù)的檢索，檢索包括：單詞檢索、多詞檢索、通配符

檢索、范圍檢索等；

b)檢索結(jié)果中應(yīng)包含命中記錄的主要元數(shù)據(jù)，如對象類別、標(biāo)識符、名稱等；

c)應(yīng)支持對檢索結(jié)果的特定元數(shù)據(jù)排序和過濾；

d)對于大量結(jié)果的檢索，接口應(yīng)支持分頁顯示，并允許設(shè)定返回結(jié)果的數(shù)量限制；

e)使用本接口前應(yīng)獲得系統(tǒng)認(rèn)證和授權(quán)，只有經(jīng)過身份驗證和授權(quán)才能訪問和使用接口。

6.5.2輸入與輸出

a)輸入包括：實體類型、檢索詞、檢索字段、分頁要求；

b)輸出包括：結(jié)果數(shù)量、命中實體的主要元數(shù)據(jù)。

6.6保存實體詳情獲取接口

6.6.1接口要求

保存實體檢索接口用于獲取版本典藏網(wǎng)站資源長期保存系統(tǒng)中某個特定實體對象的詳細(xì)信息。實體

對象包括：資源對象實體、活動實體、權(quán)利實體、責(zé)任者實體、軟件實體和環(huán)境實體。

接口要求包括：

a)輸入?yún)?shù)中應(yīng)含有能唯一確定某個資源對象的標(biāo)識符；

b)接口返回的詳細(xì)信息及實體間的關(guān)系應(yīng)以結(jié)構(gòu)化的數(shù)據(jù)格式提供；

c)如果輸入對象的標(biāo)識符無法獲取到詳情，應(yīng)向服務(wù)接口使用方返回明確的出錯消息和代碼；

d)使用本接口前應(yīng)獲得系統(tǒng)認(rèn)證和授權(quán)，只有經(jīng)過身份驗證和授權(quán)才能訪問和使用接口。

6.6.2輸入與輸出

a)輸入包括：實體類型、標(biāo)識符；

b)輸出包括：如命中則輸出實體詳細(xì)元數(shù)據(jù)，否則輸出出錯消息和代碼。

6.7網(wǎng)站回放接口

6.7.1接口要求

網(wǎng)站回放接口是版本典藏網(wǎng)站資源長期保存系統(tǒng)存儲的網(wǎng)站對象實體整體發(fā)布服務(wù)，可以回溯發(fā)布

過去某個時間點的網(wǎng)站,重現(xiàn)網(wǎng)站的狀態(tài)和內(nèi)容，查看當(dāng)時的頁面內(nèi)容、布局、交互等。

接口要求包括：

a)輸入?yún)?shù)中應(yīng)含有能唯一確定某個網(wǎng)站對象的標(biāo)識符和時間節(jié)點；

b)提供高效的數(shù)據(jù)檢索機制，使用戶能夠方便地找到并回放特定時間點的網(wǎng)站版本，回放功能

應(yīng)能夠準(zhǔn)確地呈現(xiàn)當(dāng)時網(wǎng)站的外觀和交互體驗；

c)設(shè)計健壯的錯誤處理機制，能夠在網(wǎng)站回放過程中遇到問題時進行妥善處理，并提供相應(yīng)的

錯誤提示和解決方案；

d)使用本接口前應(yīng)獲得系統(tǒng)認(rèn)證和授權(quán)，只有經(jīng)過身份驗證和授權(quán)才能訪問和使用接口。

6.7.2輸入與輸出

a)輸入包括：知識對象實體或表現(xiàn)實體的標(biāo)識符；

b)輸出包括：回放地址。

5

T/CCUAXXXX—XXXX

參考文獻

[1]GB/T29829-2022信息安全技術(shù)可信計算密碼支撐平臺功能與接口規(guī)范

[2]DB52T1541.4-2021政務(wù)數(shù)據(jù)平臺第4部分：接口規(guī)范

[3]T/CCUA017-2021政務(wù)數(shù)據(jù)共享平臺服務(wù)接口要求

6

中國計算機用戶協(xié)會團體標(biāo)準(zhǔn)

《版本典藏網(wǎng)站資源長期保存服務(wù)接口要求》

（征求意見稿）編制說明

一、標(biāo)準(zhǔn)編制的背景

典藏是文化傳承和保護的重要形式，版本典藏網(wǎng)站資源是具有極高的歷史、

文化、科研和藝術(shù)價值的互聯(lián)網(wǎng)內(nèi)容資源，將這些具有收藏價值的網(wǎng)站資源保

存起來，不僅可以為后代留下重要的歷史遺產(chǎn)，使人們更好地理解和研究文化

發(fā)展脈絡(luò)；同時也為文化傳承提供了寶貴資源，為現(xiàn)代文化的多元化和繁榮奠

定基礎(chǔ)；更為科學(xué)研究提供重要的依據(jù)和材料，有助于推動學(xué)術(shù)研究，促進科

技進步。

當(dāng)前，在互聯(lián)網(wǎng)資源保存研究與實施中還存在的重要性認(rèn)識不足、標(biāo)準(zhǔn)規(guī)

范不健全、技術(shù)能力較弱等情況，難以適應(yīng)互聯(lián)網(wǎng)異構(gòu)數(shù)據(jù)快速增長、移動互

聯(lián)網(wǎng)創(chuàng)新應(yīng)用不斷涌現(xiàn)等問題。為滿足面向50年以上互聯(lián)網(wǎng)資源存儲、檢索和

還原展示的需求，需要研制數(shù)據(jù)格式、操作流程、系統(tǒng)接口等相關(guān)標(biāo)準(zhǔn)，用以

規(guī)范技術(shù)開發(fā)和系統(tǒng)運行，實現(xiàn)互聯(lián)網(wǎng)資源長期安全存和科學(xué)管理以及與國際

互聯(lián)網(wǎng)保存標(biāo)準(zhǔn)互聯(lián)互通的目標(biāo)。

二、任務(wù)來源

根據(jù)中國計算機用戶協(xié)會下達的2023年下半年標(biāo)準(zhǔn)制修訂計劃，中國國

家版本館作為主要牽頭單位籌建了標(biāo)準(zhǔn)起草組，承擔(dān)《版本典藏網(wǎng)站資源長期

保存服務(wù)接口要求》標(biāo)準(zhǔn)的研制任務(wù)。該標(biāo)準(zhǔn)的立項計劃號為T/CCUALX011-

2023，技術(shù)歸口單位為中國計算機用戶協(xié)會。

三、編制過程

在下達計劃號前，2023年8~9月期間多次召開起草組大綱討論會。

2023年11月1日召開標(biāo)準(zhǔn)立項評審會并通過項目立項。

2023年3月完成標(biāo)準(zhǔn)工作組稿。

2024年3月，標(biāo)準(zhǔn)起草組完成了標(biāo)準(zhǔn)草案的初稿，于2023年4月初開始

在起草組評審委員會內(nèi)進行評審。共經(jīng)歷了1次組內(nèi)評審，期間收到了5條意

見。

2024年4月征求意見稿初稿提交標(biāo)準(zhǔn)委員會審核。

2024年5月20日收到標(biāo)準(zhǔn)專家馮惠（電子四院[退休]）意見7條，對不符

合標(biāo)準(zhǔn)規(guī)范性的內(nèi)容進行了修改。

2024年6月12日收到標(biāo)委會意見3條，對相應(yīng)內(nèi)容進行了修改。

四、編制原則

標(biāo)準(zhǔn)的用語、格式按照GB/T1.1-2020給出的規(guī)則起草。

標(biāo)準(zhǔn)內(nèi)容的編制堅持以下原則：

1.實用性