金融服务中基于Web服务的应用程序编程接口技术规范-编制说明

一、背景及意义

本标准等同采用ISO/TS23029:2020Web-service-based

applicationProgrammingInterface(WAPI)inFinancial

Services（金融服务中基于Web服务的应用程序接口）。

近年来，随着金融领域业务和监管规则的变化，全球各大金融机

构对金融领域WebAPI的开发和设计方法的标准化有着迫切的需求，产

生和消费数据的金融机构、中介机构和监管机构之间的交互愈加频繁

且复杂，数据传输安全性的需求日益增长。而通过定义用于开发API的

逻辑和技术分层方法，包括API的设计原则、基于Web服务的API规则、

数据有效负载和版本控制，可以有效的指导金融机构定义规范的Web

API，从而进一步提供满足上述需求的安全的、用户友好的、高效的技

术指导。

在我国，关于各金融机构基础设施间交互的WebAPI的设计规范相

对较少。而通过采标WAPI技术规范，可以引导国内金融市场的技术发

展，帮助金融机构规范应用程序编程接口，以实现数据安全高效地远

程在线同步交互；同时，采标WAPI对于提高我国金融市场标准体系的

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

二、制定原则

本标准在研制过程中，遵循开放性、稳定性和实践性原则。

开放性原则是要求《金融服务中基于Web服务的应用程序接口》尽

量与国际标准兼容，并能灵活扩充以响应业务的快速发展。

稳定性原则是指在《金融服务中基于Web服务的应用程序接口》扩

展过程中，尽量保证规范本身的相对稳定，避免因业务发展造成规范

的重大变化。

实践性原则指的是《金融服务中基于Web服务的应用程序接口》在

制订、研发过程中紧密结合实际应用，通过具体实践反馈，不断完善

标准的制订。

三、范围和主要内容

WAPI为整个金融市场基础设施之间接口的设计和数据的交互提供

了规范性指导。除标准文档必要的范围、规范性引用文件、术语和定

义章节外，正文部分主要包括以下技术内容：

（1）设计原则。作为通用性标准，WAPI标准遵循异构标准兼容、

可扩展、幂等、不可抵赖、统一标识等原则。

（2）基础技术。基础技术指的是构建基于WebAPI的程序时所必

需且关键的基础性技术。规范中识别出的关键技术包括HTTP、

Websocket和JSON。

（3）命名惯例。从技术角度而言，无论是JSON或是HTTP等，

WAPI为其中的变量名、URL规定了统一的命名规范。

（4）WAPI规范。规定了两种适用于不同业务场景的API样式，即

RESTful和ServerPush（推送）。

（5）数据载荷。数据载荷约定了通过API交互的数据格式、数据

类型等。

（6）安全与认证。WAPI对传输层面、应用层面、报文内容层面的

安全规范进行了约定，并规定了只读安全配置、读写安全配置等内

容。

（7）版本控制。基于Web暴露的服务通常使用URL来标记不同的

版本，WAPI规定了版本标记的具体规则。

（8）用例。目前已有不少机构和组织实践了基于Web的API设

计，此部分重点介绍了ISO20022标准的Web化实践方案。

四、主要工作过程

（一）项目启动

2019年5月，中国外汇交易中心主持启动《金融服务中基于Web

服务的应用程序接口》标准制定项目。

（二）成立标准工作组

2019年6月，中国外汇交易中心成立《金融服务中基于Web服务

的应用程序接口》标准工作组，规范标准化制定总体原则，标准内容

制定目标以及制定工作分配安排。

（三）标准立项

2019年7月，标准工作组将本标准的立项材料提交至金标委，按

照立项流程开展相关工作。

2019年9月，标准工作组根据金标委委员、专家意见进行会议讨

论确定修订意见，并对标准进行修订完善，形成《金融服务中基于Web

服务的应用程序接口》标准的草案稿，并提交国标委进行委员审查。

2020年8月，金标委下达立项通知。

（四）形成征求意见稿

2021年2月，标准工作组形成《金融服务中基于Web服务的应用

程序接口》标准的征求意见稿，并提交国标委进行委员审查。

五、适用范围

本标准适用于各金融机构基础设施间交互的WebAPI的设计。

六、重大分歧意见的处理和依据

无

七、国家标准属性的建议

鉴于本标准的内容未涉及强制性标准或强制性条文的内容及要

求，因此建议本标准作为推荐性国家标准。

八、废止现行有关标准的建议

无

九、其他应予说明的事项

本标准遵守中华人民共和国现行的法律和法规。

标准工作组

2021年2月

一、背景及意义

本标准等同采用ISO/TS23029:2020Web-service-based

applicationProgrammingInterface(WAPI)inFinancial

Services（金融服务中基于Web服务的应用程序接口）。

近年来，随着金融领域业务和监管规则的变化，全球各大金融机

构对金融领域WebAPI的开发和设计方法的标准化有着迫切的需求，产

生和消费数据的金融机构、中介机构和监管机构之间的交互愈加频繁

且复杂，数据传输安全性的需求日益增长。而通过定义用于开发API的

逻辑和技术分层方法，包括API的设计原则、基于Web服务的API规则、

数据有效负载和版本控制，可以有效的指导金融机构定义规范的Web

API，从而进一步提供满足上述需求的安全的、用户友好的、高效的技

术指导。

在我国，关于各金融机构基础设施间交互的WebAPI的设计规范相

对较少。而通过采标WAPI技术规范，可以引导国内金融市场的技术发

展，帮助金融机构规范应用程序编程接口，以实现数据安全高效地远

程在线同步交互；同时，采标WAPI对于提高我国金融市场标准体系的

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

二、制定原则

本标准在研制过程中，遵循开放性、稳定性和实践性原则。

开放性原则是要求《金融服务中基于Web服务的应用程序接口》尽

量与国际标准兼容，并能灵活扩充以响应业务的快速发展。

稳定性原则是指在《金融服务中基于Web服务的应用程序接口》扩

展过程中，尽量保证规范本身的相对稳定，避免因业务发展造成规范

的重大变化。

实践性原则指的是《金融服务中基于Web服务的应用程序接口》在

制订、研发过程中紧密结合实际应用，通过具体实践反馈，不断完善

标准的制订。

三、范围和主要内容

WAPI为整个金融市场基础设施之间接口的设计和数据的交互提供

了规范性指导。除标准文档必要的范围、规范性引用文件、术语和定

义章节外，正文部分主要包括以下技术内容：

（1）设计原则。作为通用性标准，WAPI标准遵循异构标准兼容、

可扩展、幂等、不可抵赖、统一标识等原则。

（2）基础技术。基础技术指的是构建基于WebAPI的程序时所必

需且关键的基础性技术。规范中识别出的关键技术包括HTTP、

Websocket和JSON。

（3）命名惯例。从技术角度而言，无论是JSON或是HTTP等，

WAPI为其中的变量名、URL规定了统一的命名规范。

（4）WAPI规范。规定了两种适用于不同业务场景的API样式，即

RESTful和ServerPush（推送）。

（5）数据载荷。数据载荷约定了通过API交互的数据格式、数据

类型等。

（6）安全与认证。WAPI对传输层面、应用层面、报文内容层面的

安全规范进行了约定，并规定了只读安全配置、读写安全配置等内

容。

（7）版本控制。基于Web暴露的服务通常使用URL来标记不同的

版本，WAPI规定了版本标记的具体规则。

（8）用例。目前已有不少机构和组织实践了基于Web的API设

计，此部分重点介绍了ISO20022标准的Web化实践方案。

四、主要工作过程

（一）项目启动

2019年5月，中国外汇交易中心主持启动《金融服务中基于Web

服务的应用程序接口》标准制定项目。

（二）成立标准工作组

2019年6月，中国外汇交易中心成立《金融服务中基于Web服务

的应用程序接口》标准工作组，规范标准化制定总体原则，标准内容

制定目标以及制定工作分配安排。

（三）标准立项

2019年7月，标准工作组将本标准的立项材料提交至金标委，按

照立项流程开展相关工作。

2019年9月，标准工作组根据金标委委员、专家意见进行会议讨

论确定修订意见，并对标准进行修订完善，形成《金融服务中基于