金融服務(wù)中基于Web服務(wù)的應(yīng)用程序編程接口技術(shù)規(guī)范-編制說明

一、背景及意義

本標(biāo)準(zhǔn)等同采用ISO/TS23029:2020Web-service-based

applicationProgrammingInterface(WAPI)inFinancial

Services（金融服務(wù)中基于Web服務(wù)的應(yīng)用程序接口）。

近年來，隨著金融領(lǐng)域業(yè)務(wù)和監(jiān)管規(guī)則的變化，全球各大金融機

構(gòu)對金融領(lǐng)域WebAPI的開發(fā)和設(shè)計方法的標(biāo)準(zhǔn)化有著迫切的需求，產(chǎn)

生和消費數(shù)據(jù)的金融機構(gòu)、中介機構(gòu)和監(jiān)管機構(gòu)之間的交互愈加頻繁

且復(fù)雜，數(shù)據(jù)傳輸安全性的需求日益增長。而通過定義用于開發(fā)API的

邏輯和技術(shù)分層方法，包括API的設(shè)計原則、基于Web服務(wù)的API規(guī)則、

數(shù)據(jù)有效負(fù)載和版本控制，可以有效的指導(dǎo)金融機構(gòu)定義規(guī)范的Web

API，從而進(jìn)一步提供滿足上述需求的安全的、用戶友好的、高效的技

術(shù)指導(dǎo)。

在我國，關(guān)于各金融機構(gòu)基礎(chǔ)設(shè)施間交互的WebAPI的設(shè)計規(guī)范相

對較少。而通過采標(biāo)WAPI技術(shù)規(guī)范，可以引導(dǎo)國內(nèi)金融市場的技術(shù)發(fā)

展，幫助金融機構(gòu)規(guī)范應(yīng)用程序編程接口，以實現(xiàn)數(shù)據(jù)安全高效地遠(yuǎn)

程在線同步交互；同時，采標(biāo)WAPI對于提高我國金融市場標(biāo)準(zhǔn)體系的

完整性也具有重要的意義。

二、制定原則

本標(biāo)準(zhǔn)在研制過程中，遵循開放性、穩(wěn)定性和實踐性原則。

開放性原則是要求《金融服務(wù)中基于Web服務(wù)的應(yīng)用程序接口》盡

量與國際標(biāo)準(zhǔn)兼容，并能靈活擴充以響應(yīng)業(yè)務(wù)的快速發(fā)展。

穩(wěn)定性原則是指在《金融服務(wù)中基于Web服務(wù)的應(yīng)用程序接口》擴

展過程中，盡量保證規(guī)范本身的相對穩(wěn)定，避免因業(yè)務(wù)發(fā)展造成規(guī)范

的重大變化。

實踐性原則指的是《金融服務(wù)中基于Web服務(wù)的應(yīng)用程序接口》在

制訂、研發(fā)過程中緊密結(jié)合實際應(yīng)用，通過具體實踐反饋，不斷完善

標(biāo)準(zhǔn)的制訂。

三、范圍和主要內(nèi)容

WAPI為整個金融市場基礎(chǔ)設(shè)施之間接口的設(shè)計和數(shù)據(jù)的交互提供

了規(guī)范性指導(dǎo)。除標(biāo)準(zhǔn)文檔必要的范圍、規(guī)范性引用文件、術(shù)語和定

義章節(jié)外，正文部分主要包括以下技術(shù)內(nèi)容：

（1）設(shè)計原則。作為通用性標(biāo)準(zhǔn)，WAPI標(biāo)準(zhǔn)遵循異構(gòu)標(biāo)準(zhǔn)兼容、

可擴展、冪等、不可抵賴、統(tǒng)一標(biāo)識等原則。

（2）基礎(chǔ)技術(shù)?；A(chǔ)技術(shù)指的是構(gòu)建基于WebAPI的程序時所必

需且關(guān)鍵的基礎(chǔ)性技術(shù)。規(guī)范中識別出的關(guān)鍵技術(shù)包括HTTP、

Websocket和JSON。

（3）命名慣例。從技術(shù)角度而言，無論是JSON或是HTTP等，

WAPI為其中的變量名、URL規(guī)定了統(tǒng)一的命名規(guī)范。

（4）WAPI規(guī)范。規(guī)定了兩種適用于不同業(yè)務(wù)場景的API樣式，即

RESTful和ServerPush（推送）。

（5）數(shù)據(jù)載荷。數(shù)據(jù)載荷約定了通過API交互的數(shù)據(jù)格式、數(shù)據(jù)

類型等。

（6）安全與認(rèn)證。WAPI對傳輸層面、應(yīng)用層面、報文內(nèi)容層面的

安全規(guī)范進(jìn)行了約定，并規(guī)定了只讀安全配置、讀寫安全配置等內(nèi)

容。

（7）版本控制?；赪eb暴露的服務(wù)通常使用URL來標(biāo)記不同的

版本，WAPI規(guī)定了版本標(biāo)記的具體規(guī)則。

（8）用例。目前已有不少機構(gòu)和組織實踐了基于Web的API設(shè)

計，此部分重點介紹了ISO20022標(biāo)準(zhǔn)的Web化實踐方案。

四、主要工作過程

（一）項目啟動

2019年5月，中國外匯交易中心主持啟動《金融服務(wù)中基于Web

服務(wù)的應(yīng)用程序接口》標(biāo)準(zhǔn)制定項目。

（二）成立標(biāo)準(zhǔn)工作組

2019年6月，中國外匯交易中心成立《金融服務(wù)中基于Web服務(wù)

的應(yīng)用程序接口》標(biāo)準(zhǔn)工作組，規(guī)范標(biāo)準(zhǔn)化制定總體原則，標(biāo)準(zhǔn)內(nèi)容

制定目標(biāo)以及制定工作分配安排。

（三）標(biāo)準(zhǔn)立項

2019年7月，標(biāo)準(zhǔn)工作組將本標(biāo)準(zhǔn)的立項材料提交至金標(biāo)委，按

照立項流程開展相關(guān)工作。

2019年9月，標(biāo)準(zhǔn)工作組根據(jù)金標(biāo)委委員、專家意見進(jìn)行會議討

論確定修訂意見，并對標(biāo)準(zhǔn)進(jìn)行修訂完善，形成《金融服務(wù)中基于Web

服務(wù)的應(yīng)用程序接口》標(biāo)準(zhǔn)的草案稿，并提交國標(biāo)委進(jìn)行委員審查。

2020年8月，金標(biāo)委下達(dá)立項通知。

（四）形成征求意見稿

2021年2月，標(biāo)準(zhǔn)工作組形成《金融服務(wù)中基于Web服務(wù)的應(yīng)用

程序接口》標(biāo)準(zhǔn)的征求意見稿，并提交國標(biāo)委進(jìn)行委員審查。

五、適用范圍

本標(biāo)準(zhǔn)適用于各金融機構(gòu)基礎(chǔ)設(shè)施間交互的WebAPI的設(shè)計。

六、重大分歧意見的處理和依據(jù)

無

七、國家標(biāo)準(zhǔn)屬性的建議

鑒于本標(biāo)準(zhǔn)的內(nèi)容未涉及強制性標(biāo)準(zhǔn)或強制性條文的內(nèi)容及要

求，因此建議本標(biāo)準(zhǔn)作為推薦性國家標(biāo)準(zhǔn)。

八、廢止現(xiàn)行有關(guān)標(biāo)準(zhǔn)的建議

無

九、其他應(yīng)予說明的事項

本標(biāo)準(zhǔn)遵守中華人民共和國現(xiàn)行的法律和法規(guī)。

標(biāo)準(zhǔn)工作組

2021年2月

一、背景及意義

本標(biāo)準(zhǔn)等同采用ISO/TS23029:2020Web-service-based

applicationProgrammingInterface(WAPI)inFinancial

Services（金融服務(wù)中基于Web服務(wù)的應(yīng)用程序接口）。

近年來，隨著金融領(lǐng)域業(yè)務(wù)和監(jiān)管規(guī)則的變化，全球各大金融機

構(gòu)對金融領(lǐng)域WebAPI的開發(fā)和設(shè)計方法的標(biāo)準(zhǔn)化有著迫切的需求，產(chǎn)

生和消費數(shù)據(jù)的金融機構(gòu)、中介機構(gòu)和監(jiān)管機構(gòu)之間的交互愈加頻繁

且復(fù)雜，數(shù)據(jù)傳輸安全性的需求日益增長。而通過定義用于開發(fā)API的

邏輯和技術(shù)分層方法，包括API的設(shè)計原則、基于Web服務(wù)的API規(guī)則、

數(shù)據(jù)有效負(fù)載和版本控制，可以有效的指導(dǎo)金融機構(gòu)定義規(guī)范的Web

API，從而進(jìn)一步提供滿足上述需求的安全的、用戶友好的、高效的技

術(shù)指導(dǎo)。

在我國，關(guān)于各金融機構(gòu)基礎(chǔ)設(shè)施間交互的WebAPI的設(shè)計規(guī)范相

對較少。而通過采標(biāo)WAPI技術(shù)規(guī)范，可以引導(dǎo)國內(nèi)金融市場的技術(shù)發(fā)

展，幫助金融機構(gòu)規(guī)范應(yīng)用程序編程接口，以實現(xiàn)數(shù)據(jù)安全高效地遠(yuǎn)

程在線同步交互；同時，采標(biāo)WAPI對于提高我國金融市場標(biāo)準(zhǔn)體系的

完整性也具有重要的意義。

二、制定原則

本標(biāo)準(zhǔn)在研制過程中，遵循開放性、穩(wěn)定性和實踐性原則。

開放性原則是要求《金融服務(wù)中基于Web服務(wù)的應(yīng)用程序接口》盡

量與國際標(biāo)準(zhǔn)兼容，并能靈活擴充以響應(yīng)業(yè)務(wù)的快速發(fā)展。

穩(wěn)定性原則是指在《金融服務(wù)中基于Web服務(wù)的應(yīng)用程序接口》擴

展過程中，盡量保證規(guī)范本身的相對穩(wěn)定，避免因業(yè)務(wù)發(fā)展造成規(guī)范

的重大變化。

實踐性原則指的是《金融服務(wù)中基于Web服務(wù)的應(yīng)用程序接口》在

制訂、研發(fā)過程中緊密結(jié)合實際應(yīng)用，通過具體實踐反饋，不斷完善

標(biāo)準(zhǔn)的制訂。

三、范圍和主要內(nèi)容

WAPI為整個金融市場基礎(chǔ)設(shè)施之間接口的設(shè)計和數(shù)據(jù)的交互提供

了規(guī)范性指導(dǎo)。除標(biāo)準(zhǔn)文檔必要的范圍、規(guī)范性引用文件、術(shù)語和定

義章節(jié)外，正文部分主要包括以下技術(shù)內(nèi)容：

（1）設(shè)計原則。作為通用性標(biāo)準(zhǔn)，WAPI標(biāo)準(zhǔn)遵循異構(gòu)標(biāo)準(zhǔn)兼容、

可擴展、冪等、不可抵賴、統(tǒng)一標(biāo)識等原則。

（2）基礎(chǔ)技術(shù)?；A(chǔ)技術(shù)指的是構(gòu)建基于WebAPI的程序時所必

需且關(guān)鍵的基礎(chǔ)性技術(shù)。規(guī)范中識別出的關(guān)鍵技術(shù)包括HTTP、

Websocket和JSON。

（3）命名慣例。從技術(shù)角度而言，無論是JSON或是HTTP等，

WAPI為其中的變量名、URL規(guī)定了統(tǒng)一的命名規(guī)范。

（4）WAPI規(guī)范。規(guī)定了兩種適用于不同業(yè)務(wù)場景的API樣式，即

RESTful和ServerPush（推送）。

（5）數(shù)據(jù)載荷。數(shù)據(jù)載荷約定了通過API交互的數(shù)據(jù)格式、數(shù)據(jù)

類型等。

（6）安全與認(rèn)證。WAPI對傳輸層面、應(yīng)用層面、報文內(nèi)容層面的

安全規(guī)范進(jìn)行了約定，并規(guī)定了只讀安全配置、讀寫安全配置等內(nèi)

容。

（7）版本控制?；赪eb暴露的服務(wù)通常使用URL來標(biāo)記不同的

版本，WAPI規(guī)定了版本標(biāo)記的具體規(guī)則。

（8）用例。目前已有不少機構(gòu)和組織實踐了基于Web的API設(shè)

計，此部分重點介紹了ISO20022標(biāo)準(zhǔn)的Web化實踐方案。

四、主要工作過程

（一）項目啟動

2019年5月，中國外匯交易中心主持啟動《金融服務(wù)中基于Web

服務(wù)的應(yīng)用程序接口》標(biāo)準(zhǔn)制定項目。

（二）成立標(biāo)準(zhǔn)工作組

2019年6月，中國外匯交易中心成立《金融服務(wù)中基于Web服務(wù)

的應(yīng)用程序接口》標(biāo)準(zhǔn)工作組，規(guī)范標(biāo)準(zhǔn)化制定總體原則，標(biāo)準(zhǔn)內(nèi)容

制定目標(biāo)以及制定工作分配安排。

（三）標(biāo)準(zhǔn)立項

2019年7月，標(biāo)準(zhǔn)工作組將本標(biāo)準(zhǔn)的立項材料提交至金標(biāo)委，按

照立項流程開展相關(guān)工作。

2019年9月，標(biāo)準(zhǔn)工作組根據(jù)金標(biāo)委委員、專家意見進(jìn)行會議討

論確定修訂意見，并對標(biāo)準(zhǔn)進(jìn)行修訂完善，形成《金融服務(wù)中基于