GB/Z 104-2025 金融服务中基于互联网服务的应用程序编程接口技术规范

标准编号：GB/Z 104-2025

标准名称：金融服务中基于互联网服务的应用程序编程接口技术规范

英文名称：Technical specification of web-service-based application programming interface（WAPI）in financial services

发布日期：2025-12-03

实施日期：2025-12-03

提出单位：全国金融标准化技术委员会

归口单位：全国金融标准化技术委员会

批准发布部门：中国人民银行

起草人

胡剑、孙英昊、卢艳民、包晓晶、沈薇薇、马洪杰、杨帆、李正、贺宇、唐卓、李坤

起草单位

中国外汇交易中心(全国银行间同业拆借中心)、北京国家金融标准化研究院有限责任公司、神州数码信息服务集团股份有限公司、中汇信息技术（上海）有限公司、跨境银行间支付清算有限责任公司

标准范围

本文件规定了金融服务中常见的基于互联网（Web）服务的应用程序编程接口（API）生态系统的框架、功能和协议，以实现在线同步交互。具体内容包括：

——定义了用于开发API的逻辑和技术分层方法，包括转换规则，不包括特定的逻辑模型［例如ISO 20022（所有部分）模型］，但在特定的场景下会引用逻辑模型用来指导定义API；

——以表现层状态转换（RESTful）设计的角度为主，同时也包含了其他场景提供的架构样式，如网络套接字（WebSocket）和网络钩子（Webhook）；

——定义了API的设计原则、基于Web服务的API规则、数据有效负载和版本控制；

——列出了与API设计的安全性、身份和注册相关的注意事项。

本文件适用于金融服务行业基于Web服务的API的设计和应用，为金融机构内部、金融机构与应用方之间共享数据和服务提供参考。

本文件不适用于以下内容：

——金融服务中API实施的特定技术规范；

——基于ISO 20022（所有部分）特定报文格式开发的脚本对象简谱，一种轻量级的数据交换格式（JSON）API；

——由特定法律框架定义或确定的技术规范。

标准文档截图