1 Introduction
本文档旨在为 OP 架构中较低层的服务 API 实现创建一个基准。通过这种方式，合作伙伴和运营商可以使用它作为参考实现，涵盖计费、联盟、差距和填充服务差距的建议使能器等方面。
1.1 Overview
本文档的目标是创建一个基准，为 OP 架构中较低层的服务 API 实现提供参考。
1.2 Scope
本文档为运营商提供指南，说明服务 API 应如何在网络中实现，识别缺失的接口或使能器，并将 SDO 和更广泛的行业与服务开发的需求保持一致。
1.3 Definitions
定义部分未在摘要中体现。
1.4 Abbreviations
缩写部分未在摘要中体现。
1.5 References
引用部分未在摘要中体现。
1.6 Conventions
规范部分未在摘要中体现。
2 Northbound CAMARA APIs Analysis
本文档分析了多个 CAMARA 北向 API 的实现，包括 UE 识别、授权和认证、通用错误代码、CarrierBilling API、Device Location APIs、Number Verification API、QualityOnDemand API、Traffic Influence API、KYC Match API、KYC Fill-in API、OTP SMS API、Device Status API、Edge Cloud Discovery APIs、Call Forwarding Signal API 和 Connectivity Insights。
2.1 UE identification
应用提供者可以使用 GPSI（任何可能存在的格式）或 UE IP 地址或以太网 MAC 地址（与应用提供者标识符一起使用）来识别 CAMARA API 指向的 UE。如果 API 调用者在使用 API 时提供 IP 地址或 GPSI，则可能需要将其转换为 MSISDN。
2.2 Authorization and authentication
授权流程的选择将在 API 客户端和暴露 API 的电信运营商之间的 onboarding 过程中确定，考虑到访问 API 的声明目的，同时也要受到当地立法规定的现行法律框架的约束。如果 API 处理个人用户数据，并且用户可以通过 opt-in 和/或 opt-out 等机制行使他们的权利，则必须使用三腿访问令牌。
2.3 Generic error codes
以下错误代码适用于所有当前 v1.0 的 CAMARA API（Number Verification、OTP SMS validation、location verification 和 Simple Edge Discovery）。
2.4 CarrierBilling API
本文档考虑的 CAMARA CarrierBilling API 版本是 ver. 0.2.0。该 API 允许应用提供者请求（一组）商品/服务的付款，以及检索有关特定付款或付款列表的信息。运营商将解释 CarrierBilling API 请求并将其转换为对运营商业务支持系统 (BSS) 的专有请求。
2.5 Device Location APIs
设备位置 API 包括 Location Retrieval API、Location Verification API 和 Device Geofencing API。这些 API 允许应用客户端检索特定终端用户的设备所在区域，并验证设备的位置。
2.6 Number Verification API
Number Verification API 允许应用客户端验证提供的“手机号码”是否是设备上使用的号码。它还使应用提供者能够验证与经过身份验证的用户电话号码相关联的号码（使调用者能够进行验证）。
2.7 QualityOnDemand API
QualityOnDemand API 允许应用开发者和其他消费此功能的实体请求移动网络中的特定数据包延迟预算或吞吐量，而无需深入了解 4G/5G 系统或电信系统的整体复杂性。该 API 提供了以下功能：设置移动连接的质量（例如所需的包延迟（延迟）、吞吐量）以及如果网络无法满足请求则接收通知。
2.8 Traffic Influence API
Traffic Influence API 提供了从最终用户设备（例如智能手机）到特定地理位置中安装在边缘云区域（电信运营商的边缘数据中心）或云中的最佳 EAS 实例的最快路由。如果服务由云实例和边缘实例提供，则可以使用 TI API 获取到到边缘实例的最佳流量路由，可能针对一组最终用户。提供最佳路由确实是一个重要步骤，可以与 CAMARA API（例如 QoD）结合使用，以提高延迟。
2.9 KYC Match API
KYC Match API 提供了比较应用者拥有的特定最终用户信息与其运营商在其自己的 KYC 记录中保存的已验证信息的能力，以便应用者确认信息的准确性并提供特定服务。信息可以包括电话号码、姓名、邮政编码、地址、出生日期、电子邮件地址等。没有返回个人身份信息 (PII)。
2.10 KYC Fill-in API
KYC Fill-in API 提供了请求和接收最终用户信息的能力，这些信息由最终用户的运营商在其自己的 KYC 记录中保存（并已验证），以便应用者确认信息的准确性并提供特定服务。
2.11 OTP SMS API
OTP SMS API 提供了一种方法，通过发送一次性密码 (OTP) 通过 SMS 并随后验证它来执行实时检查，以验证用户是否拥有设备。此 API 允许应用提供者验证提供的“手机号码”是否是设备上使用的号码。
2.12 Device Status API
Device Status API 提供了以下功能：检查设备是否可达或未连接到网络、检查设备是否正在漫游以及正在哪个国家、查询设备连接到的移动通信技术、接收连接性或漫游状态发生变化的通知以及订阅设备连接网络类型发生变化的通知。
2.13 Edge Cloud Discovery APIs
Simple Edge Discovery API 允许客户端应用程序发现托管客户端应用程序的最终用户设备最近的边缘云区域。'最近'意味着'最短网络路径'，因为这将给出最短的传播距离，这是延迟的主要因素。
2.14 Call Forwarding Signal API
Call Forwarding Signal API 提供了有关特定电话号码上 Call Forwarding 服务状态的信息。该 API 的主要范围是“反欺诈”，以避免欺诈者使用 Call Forwarding 服务进行诈骗。Call Forwarding 服务通常用于此欺诈的是无条件 Call Forwarding。Call Forwarding Signal API 还提供了其他端点来检测一般的 Call Forwarding 服务设置。
2.15 Connectivity Insights
Connectivity Insights API 家族允许消费者（例如应用后端）从网络请求对确定应用程序的性能要求是否可以满足特定最终用户的会话有用的信息。根据网络响应，应用后端可以请求网络增强（例如，通过 CAMARA Quality-on-Demand API 调用），和/或在应用侧应用特定更改，例如调整下行视频流的分辨率。
2.16 SIM Swap API
SIM Swap API 提供了可编程接口，用于 API 消费者和开发人员检查是否在特定时间段内为给定 MSISDN 发生了 SIM 交换，或检索最新 SIM 交换发生的日期/时间戳（如果有的话）。
