OPG.13-开放网关操作API技术实现指南，1.0版

Version1.0 17 December 2025 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. Theinformation containedin this document may be subject to change without prior notice. Compliance Notice The information containedherein 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 outinGSMA AA.35-Procedures for Industry Specifications. GSMANon-ConfidentialOfficial Document OPG.13–Open Gateway Operate APIs Technical Realisation Guidelines Table of Contents 1Introduction1.1Overview1.2Scope1.2.1Audience1.3Definitions1.4Abbreviations1.5References1.6Conventions 2Aggregation Mode3TMF Operate APIs: common realisation guidelines 3.1Synchronous vs Asynchronous Operations93.2String Formats and Limits93.3API Security103.4API Web Notifications Security103.5HTTP X-Correlator Header113.6HTTP Language Selection11 4TMF931 Onboarding and Ordering API Guidelines 4.1TMF931 Mandatory Operations4.2TMF931 API Security4.3Channel Partner Onboarding Process4.4Approval Status4.5Tax Number Format4.6ApiProductOrder4.7Event Subscriptions4.8Monitor4.9Full Onboarding And Ordering Process4.10PATCH Operation4.11Regional Guidelines4.11.1Brazil4.11.2European Union 5TMF936 Product Catalogue API Guidelines6TMF937 Product Usage API Guidelines AnnexAExamplesA.1Onboarding API ExamplesA.1.1Application OwnerA.1.2ApplicationOwner (EU GDPR)A.1.3ApplicationA.1.4Application (EU GDPR)A.1.5ApiProductOrderA.1.6ApiProductOrder (EU GDPR)A.1.7ApiProductA.1.8Hub–Event Subscriptions GSMANon-ConfidentialOfficial Document OPG.13–Open Gateway Operate APIs Technical Realisation Guidelines AnnexBDocument Management B.1Document HistoryB.2Other Information 4646 GSMANon-ConfidentialOfficial Document OPG.13–Open Gateway Operate APIs Technical Realisation Guidelines 1Introduction 1.1Overview In the dynamic telecommunications industry, the GSMA Open Gateway initiative representsa significant step toward unified and standardised service delivery and management acrossnetwork operators. This initiative seeks to enhance interoperability, streamline servicemanagement, and foster innovation through standardised APIs, ensuring a seamless andconsistent user experience across diverse networks. The GSMA Open Gateway(OGW)Platformis a deployment option of the GSMAOperator Platform[2]. This GSMA Open Gateway Operate API TechnicalRealisationGuideline document servesas an essential resource for stakeholders (includingOperators, service aggregators, andtechnology partners) who are involved in deploying and utilising the GSMA Open GatewayService APIs. Thisrealisationguideline outlines the required steps, best practices, andtechnical specifications necessary for successful implementation and utilisation of TMForumOperate APIs. TMForum Operate APIs are designed as part of the GSMA and TMForum collaboration fortheOpen Gatewayinitiativeand provide a technical solution for therequirementsdefinedinOpen Gateway Channel Partner Onboarding Guide[1]and inthe Operator Platform:Requirements and Architecture[2]. This document provides detailedrealisationguidelines forintegrationofthe Open GatewayPlatformin the Aggregationmodel(anAggregator integrates someOperators' APIs) definedin GSMAPRDOPG.10 Open Gateway Technical Realisation Guidelines[3]. Note:Operator Federationmodeis ForFurtherStudy. 1.2Scope The purpose of this document is to provide a technical integration guidelinefor third partiessuch as cloud hyperscalersor other services providers interested in becoming part of theOpen Gateway ecosystem as Aggregators/Channel Partnersandmakeuse of API productofferings from Operators. This document covers the utilisation of Operate APIs for the API productcatalogueretrieval,API productorderingand APIproductusage retrieval. 1.2.1Audience This guideline is intended for: •Operators: Technical and operational teams responsible for managing networkservices.•ChannelPartnersEntities that offer bundled services across multiple MNOs,requiring standardised and interoperable interfaces.•Regulatory Bodies: Authorities overseeing compli