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