金融服务中基于互联网服务的应用程序编程接口技术规范 (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的功能来处理文档的示例。