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