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

适用范围

本文件规定了金融服务中常见的基于互联网（Web）服务的应用程序编程接口（API）生态系统的框架、功能和协议，以实现在线同步交互。具体内容包括：
——定义了用于开发API的逻辑和技术分层方法，包括转换规则，不包括特定的逻辑模型［例如ISO 20022（所有部分）模型］，但在特定的场景下会引用逻辑模型用来指导定义API；
——以表现层状态转换（RESTful）设计的角度为主，同时也包含了其他场景提供的架构样式，如网络套接字（WebSocket）和网络钩子（Webhook）；
——定义了API的设计原则、基于Web服务的API规则、数据有效负载和版本控制；
——列出了与API设计的安全性、身份和注册相关的注意事项。
本文件适用于金融服务行业基于Web服务的API的设计和应用，为金融机构内部、金融机构与应用方之间共享数据和服务提供参考。
本文件不适用于以下内容：
——金融服务中API实施的特定技术规范；
——基于ISO 20022（所有部分）特定报文格式开发的脚本对象简谱，一种轻量级的数据交换格式（JSON）API；
——由特定法律框架定义或确定的技术规范。
注：附录A给出了如何根据特定业务领域或所需API的功能来处理文档的示例。

研制信息

采用标准

相关标准