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

一、背景及意義

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

applicationProgrammingInterface(WAPI)inFinancial

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

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

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

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

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

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

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

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

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

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

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

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

程在線同步交互；同時(shí)，采標(biāo)WAPI對(duì)于提高我國(guó)金融市場(chǎng)標(biāo)準(zhǔn)體系的

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

二、制定原則

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

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

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

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

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

的重大變化。

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

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

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

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

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

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

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

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

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

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

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

Websocket和JSON。

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

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

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

RESTful和ServerPush（推送）。

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

類(lèi)型等。

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

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

容。

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

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

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

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

四、主要工作過(guò)程

（一）項(xiàng)目啟動(dòng)

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

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

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

2019年6月，中國(guó)外匯交易中心成立《金融服務(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)立項(xiàng)

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

照立項(xiàng)流程開(kāi)展相關(guān)工作。

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

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

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

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

（四）形成征求意見(jiàn)稿

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

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

五、適用范圍

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

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

無(wú)

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

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

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

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

無(wú)

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

本標(biāo)準(zhǔn)遵守中華人民共和國(guó)現(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ái)，隨著金融領(lǐng)域業(yè)務(wù)和監(jiān)管規(guī)則的變化，全球各大金融機(jī)

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

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

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

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

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

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

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

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

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

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

程在線同步交互；同時(shí)，采標(biāo)WAPI對(duì)于提高我國(guó)金融市場(chǎng)標(biāo)準(zhǔn)體系的

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

二、制定原則

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

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

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

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

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

的重大變化。

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

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

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

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

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

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

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

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

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

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

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

Websocket和JSON。

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

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

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

RESTful和ServerPush（推送）。

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

類(lèi)型等。

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

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

容。

（7）版本控制。基于Web暴露的服務(wù)通常使用URL來(lái)標(biāo)記不同的

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

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

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

四、主要工作過(guò)程

（一）項(xiàng)目啟動(dòng)

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

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

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

2019年6月，中國(guó)外匯交易中心成立《金融服務(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)立項(xiàng)

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

照立項(xiàng)流程開(kāi)展相關(guān)工作。

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

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