OPG.09-SBI中NBI API的实现

Security Classification:Non-Confidential Access to and distribution of this document is restricted to the personspermitted by the securityclassification. This document is subject tocopyright protection. This document is to be used only for the purposes for which it has been supplied and information contained in it must not bedisclosed or in any other way made available, in whole or in part,to persons other than thosepermitted under the securityclassification withoutthe prior written approval of the Association. Copyright Notice Copyright ©2026GSM Association Disclaimer The GSMA makes no representation, warranty or undertaking (express or implied) with respect to and does not accept any responsibility for, andhereby disclaims liability for the accuracy or completeness or timeliness of the information contained in this document. The information containedin this document may be subject to change without prior notice. Compliance Notice The information contain herein is in full compliance with the GSMAAntitrustCompliancePolicy. This Permanent Reference Document is classified by GSMA as an Industry Specification, as such it has been developed and is maintained byGSMA in accordance with the provisions set out GSMA AA.35-Procedures for Industry Specifications. GSMAChange Request OPG.09 CR1005 Table of Contents 1Introduction 1.1Overview1.2Scope1.3Definitions1.4Abbreviations1.5References1.6Conventions 555792Northbound CAMARA APIs Analysis102.1UE identification102.2Authorization and authentication102.3Generic error codes112.4CarrierBilling API112.4.1Description112.4.2SBI Realisation122.4.3Charging Aspects122.4.4Roaming (Home Routed scenario) Aspect122.4.5Federation Aspects122.5Device Location APIs132.5.1Location Retrieval API132.5.2Location Verification API152.5.3Device Geofencing API202.6Number Verification API242.6.1Description242.6.2SBI Realisation262.6.3Charging Aspects262.6.4Roaming (Home Routed scenario) Aspect262.6.5Federation Aspects262.6.6Error codes262.7QualityOnDemand APIs262.7.1Quality-On-Demand API272.7.2QoS Profiles API412.7.3QoD Provisioning API442.8Traffic Influence API442.8.1Description442.8.2SBI Realization462.8.3Charging Aspects512.8.4Roaming (Home Routed scenario) Aspect512.8.5Federation Aspects512.9KYC Match API512.9.1Description512.9.2SBI Realization522.9.3Charging Aspects522.9.4Roaming (Home Routed scenario) Aspect52 2.9.5Federation Aspects2.9.6Error codes2.10KYC Fill-in API2.10.1Description2.10.2SBI Realization2.10.3Charging Aspects2.10.4Roaming (Home Routed scenario) Aspect2.10.5Federation Aspects2.10.6Error codes2.11OTP SMS API2.11.1Description2.11.2SBI Realization2.11.3Charging Aspects2.11.4Roaming (Home Routed scenario) Aspect2.11.5Federation Aspects2.11.6Error codes2.12Device Status APIs2.12.1Device Reachability Status2.12.2Device Reachability Status Subscription API2.12.3Device Roaming Status Subscription API2.12.4Connected Network Type API2.12.5Connected Network Type Subscription API2.12.6Charging Aspects2.12.7Roaming (Home Routed scenario) Aspect2.12.8Federation Aspects2.13Edge Cloud Discovery APIs2.13.1Simple Edge Discovery API2.14Call Forwarding Signal API2.14.1Description2.14.2SBI Realization2.14.3Charging Aspects2.14.4Roaming (Home Routed scenario) Aspect2.14.5Federation Aspects2.15Connectivity Insights2.15.1Description2.15.2SBI Realisations2.15.3Charging Aspects2.15.4Roaming (Home Routed scenario) Aspect2.15.5Federation Aspects2.15.6Error codes2.16SIM Swap APIs2.16.1SIM Swap2.16.2SIM Swap Subscriptions2.16.3Charging Aspects2.16.4Roaming (Home Routed scenario) Aspect 525253535455555555565656575757575959656565666666666666737374747474757577838383838686889191 GSMAChange Request OPG.09 CR1005 2.16.5Federation Aspects912.17Device Swap API912.17.1Description912.17.2SBI Realization922.17.3Charging Aspects932.17.4Roaming (Home Routed scenario) Aspect932.17.5Federation Aspects932.17.6Error codes93AnnexADocument Management95A.1Document History95A.2Other Information95 1Introduction 1.1Overview The idea of this document is creating a baseline for the realisation of Service APIs at lowerlevels in the OP architecture. This way partners and operators can use it as a referenceimplementation covering aspects such as charging, federation, gaps and recommendedenablers to fill those service gaps. 1.2Scope This document provides guidelines to operators on how Service APIs should beimplemented in the network identifying missing interfaces or enablers and aligning SDOsand the wider industry to the needs for service development. 1.3Definitions 1.4Abbreviations 1.5References 1.6Conventions “The key words “MUST”, “MUST NOT”, “REQUIRED”, “SHALL”, “SHALL NOT”, “SHOULD”,“SHOULD NOT”, “RECOMMENDED”, “MAY”, and “OPTIONAL” in this document are to be interpreted as described in RFC 2119[1]and clarified by RFC8174[2], when, and onlywhen, they appear in all capitals, as shown here.” 2Northbound CAMARA APIs Analysis 2.1UE identification Different solutions needed by several CAMARA APIs f