ICS 33.060 YD CCS M36 中华人民共和国通信行业标准 YD/T4360—2023 面向移动通信网的通用应用程序接口（API） 架构技术要求 Technique reguirement for common Application Program Interface (APD) framework towards mobile network 2023-07-28发布 2023-11-01实施 中华人民共和国工业和信息化部 发布 YD/T4360—2023 目 次 前言 .IV 1 范围. 2 规范性引用文件 3 术语和定义 缩略语. 5 CAPIF总体要求 5.1 总体要求， 5.2 发布和发现服务API的要求. 5.3 安全性要求， 5.4 计费要求 5.5 运营、管理和维护要求.. 5.6 监控服务API调用情况的要求. 5.7 日志记录要求.... 5.8 审核服务API调用情况的要求 5.9 API调用者的注册要求 5.10 策略配置要求 5.11 协议设计要求， 5.12 CAPIF提供者之间的互连要求.. 5.13 5.14 API提供域的交互要求... 5.15 调用服务API的动态路由选择要求， 5.16 注册API提供者域的功能要求.. 6 CAPIF中的业务关系， 6 功能模型 7.1 概述.. 7.2 模型要求. 7.3 功能实体要求. 13 7.4 参考点描述. 14 8 功能模型在部署中的应用 8.1 概述. 17 8.2 集中式部署， 17 8.3 分布式部署. 18 8.4 多个CAPIF核心功能的部署 21 9 流程 9.1 API调用者在CAPIF中注册 21 YD/T4360—2023 9.2API调用者从CAPIF中注销 23 9.3 服务API的发布 25 9.4 服务API取消发布 26 9.5 服务API的检索 27 9.6 服务API的更新. 29 9.7 服务API的发现.. 30 9.8 CAPIF中事件的订阅、退订和通知.. 9.9 撤销CAPIF订阅的事件.. 37 9.10 API调用者和CAPIF核心功能之间的身份验证 38 9.11 API调用者获得授权以访问服务API. 39 9.12 AEF获得访问服务API的控制策略， 40 9.13 拓扑隐藏. 9.14 在调用服务API前，API调用者和AEF之间的身份验证， 43 9.15 在调用服务API时，API调用者和AEF之间的身份验证.. 43 9.16 给API调用者授权以访问服务API.. 45 9.17 CAPIF的访问控制... 47 9.18 具有级联AEF的CAPIF的访问控制， 48 9.19 记录服务API的调用.. 49 9.20 调用服务API的计费流程.. 51 9.21 调用服务API的监控流程. 52 9.22 调用服务API的审核流程.. 52 9.23 CAPIF撤销API调用者的授权 54 9.24 API拓扑隐藏管理 57 9.25 支持CAPIF的互连. 58 9.26 更新API调用者的API列表.. .62 9.27 调用服务API的动态路由选择. 64 9.28 在CAPIF中注册API提供域的功能 65 9.29 在CAPIF中更新API提供域的注册信息 67 10API一致性要求 68 10.1 概述， 68 10.2 基本API要求 .68 10.3 架构设计要求， 69 11 CAPIF与应用接口的公用信息 69 11.1概述， .69 11.2 数据格式.. 11.3 针对HTTP用法的约定 70 11.4 URI结构. 11.5 通知方法. 71 11.6 异常处理 71 11.7 能力协商... 11.8 HTTP头部 72 11.9 OpenAPI标准文件的惯常约定 II YD/T4360—2023 12CAPIF核心功能中的API.. .72 12.1 概述... 12.2 CAPIF中发现服务API的API（CAPIFDiscover Service API) 12.3 CAPIF中发布服务API的API（CAPIF_Publish_Service_API） .78 12.4 CAPIF中事件相关的API（CAPIFEvents） 92 12.5 CAPIF中管理API调用者的API（CAPIF_APIinvoker_management） .. 103 12.6 CAPIF安全性相关的API（CAPIFSecurity） ...115 12.7 CAPIF中监控相关的API（CAPIF_Monitoring） ...130 12.8 CAPIF中记录API调用的API（CAPIF_Logging_API_Invocation） 130 12.9 CAPIF中审核相关的API（CAPIFAuditing） .135 12.10 CAPIF中访问控制策略相关的API（CAPIFAccessControlPolicy） .139 12.11 CAPIF中API提供者管理接（CAPIF_API_Provider_Management_API） 12.12 CAPIF中API路由信息管理接口（CAPIF_Routing_Info_API） .152 13API开放功能中的API .156 13.1概述. 156 13.2AEF安全性相关的API（AEF_Security） .157 附录A（资料性）CAPIF操作流程概述， .162 附录B（资料性）CAPIF与3GPP系统的网络能力开放的关系. 164 附录C（资料性）CAPIF在计费中的作用 174 附录D（资料性）CAPIF与外部API架构的关系 .176 参考文献 177 II YD/T4360—2023 前言 本文件按照GB/T1.1一2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由中国通信标准化协会提出并归口。 本文件起草单位：中国电信集团有限公司、中国移动通信集团有限公司、深圳市腾讯计算机系统有 限公司、华为技术有限公司、中兴通讯股份公司、中国信息通信科技集团有限公司、博鼎实华（北京） 技术有限公司。 本文件主要起草人：李金艳、周星月、杨帆、张卓筠、徐晖、黄震宁、姜永、靳涛。 IV YD/T4360—2023 前言 本文件按照GB/T1.1一2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由中国通信标准化协会提出并归口。 本文件起草单位：中国电信集团有限公司、中国移动通信集团有限公司、深圳市腾讯计算机系统有 限公司、华为技术有限公司、中兴通讯股份公司、中国信息通信科技集团有限公司、博鼎实华（北京） 技术有限公司。 本文件主要起草人：李金艳、周星月、杨帆、张卓筠、徐晖、黄震宁、姜永、靳涛。 IV YD/T4360—2023 前言 本文件按照GB/T1.1一2020《标准化工作导则第1部分：标准化文件的结构和起草规则》的规定 起草。 请注意本文件的某些内容可能涉及专利。本文件的发布机构不承担识别专利的责任。 本文件由中国通信标准化协会提出并归口。 本文件起草单位：中国电信集团有限公司、中国移动通信集团有限公司、深圳市腾讯计算机系统有 限公司、华为技术有限公司、中兴通讯股份公司、中国信息通信科技集团有限公司、博鼎实华（北京） 技术有限公司。 本文件主要起草人：李金艳、周星月、杨帆、张卓筠、徐晖、黄震宁、姜永、靳涛。 IV