2025-02-27 API backlog minutes
Attendees
Organization | Name |
Orange |
|
Charter Communications | @Christopher Aubut |
CableLabs |
|
Telefonica | @Jorge Garcia Hospital @Alberto Ramos Monaga |
Vodafone | @Kevin Smith |
Ericsson | @Jan Friman |
AT&T |
|
T-Mobile US |
|
KDDI |
|
Slagen |
|
Nokia |
|
China Telecom | @Moyuan Sun |
ZTE |
|
KPN |
|
GSMA | @Reg Cox |
Centilion |
|
Chunghwa Telecom |
|
Deutsche Telekom |
|
MTN |
|
China Mobile |
|
Verizon |
|
PlektonLabs | @Wahid Mohammad |
TIM | @Antonio Varvara , @fabrizio moggio |
NTT |
|
China Unicom |
|
Agenda Proposal
New APIs Proposals:
#35 (5G New Calling), #63 (IMEI Fraud), #17 (Consent and Measurement), #23 (Carrier Wholesale Pricing), #24 (Steering of Roaming Information), #115 (SIM Historical Information), #121 (User Account Spend Count), #122 (Number Of Cards Under User's ID), #127 (Network Health Assessment), #128 (Network Traffic Analysis), #136 (eSIM Remote Management), #143 (IoT Data Transfer Activation), #157 (Voice Notification), #160 (Voice Verification Code), #163 (Dynamic Connectivity Data), #167 (IdentityAndConsentManagement),
Out of Agenda:
#141 (Energy Footprint Notification), , #126 (Facial Recognition), #154 (QoS Booking), #22 (Capability and Runtime Restrictions), #18 (Receive SMS), #89 (IP High-throughput Elastic Network), #41 (Telco Scoring), #83 #85 #86 #87 (Model as a Service), #20 (Best Interconnection), #68 (Consent URL), #91 (Fixed lines in Device Location APIs), #93 (Line Eligibility for Carrier Billing API), #50 (Device Management) #95 (IoT SIM Status Mgmt API), #96 (IoT SIM Fraud Prevention API), Sandbox Repository for Traffic Influence API (#169), #109 (Support application resource requirements in application profiles)
Approval of minutes of last conf. call
Minutes of last API backlog WG call available here
DECISION: approved
Antitrust Policy
The project's Antitrust Policy, which you can find linked from the LF and project websites. The policy is important where multiple companies, including potential industry competitors, are participating in meetings. Please review and if you have any questions, please contact your company legal counsel. Members of the LF may contact Andrew Updegrove at the firm Gesmer Updegrove LLP, which provides legal counsel to the LinusFoundation.
|
|
New Procedures in API Backlog WG meetings
A number of improvements are under discussion with leadership team of OGW project (Henry), CAMARA Project (Markus), Product Definition WS (Helene) and TSC (Herbert). As of today, the WG adopted agreements are three:
To close the agenda SEVEN DAYS BEFORE the conf. call.
In case a WG participant wants to include a point in the agenda (e.g., present a new API proposal), this participant shall ensure the corresponding issue is opened in Github by then.
Exceptional situations will be treated separately.
New schedule of conf. calls **The meetings are to be held by Linux Foundation (Links available at GitHub and Confluence Backlog front pages)
2nd Thursday of the month (9-10:30 UTC)
4th Thursday of the month (15-16:30 UTC)
Send agenda to TSC mail list, to encourage more TSC member companies to join the call and provide comments when they identify APIs which are of interest for them.
New API proposals are included in backlog table when template PR is created, linking to the pending PR
PR will be merged as soon as ready for TSC, and should be merged before TSC review
API enhancements requires existing group’s validation. TSC is informed accordingly to validate
Link and status in backlog table will be updated accordingly
Issue to track API onboarding will be opened once new API is confirmed in TSC.
Recent Updates & Recap
TSC meeting 20th February:
2 new API proposal(s) from APIBacklog working group
Device Management, supported by Verizon and China Telecom.
New Sandbox proposed to solve IoT device management use cases including:
Communication Function Management
Device Subscription State Management
Real-Time Monitoring
Original Issue #50 & #95; Device Management template
@Jose Luis Urien Pinedo raised the point about the proposed name to generic
IoT Device Management is probably better as repository name
@Tanja de Groot raised the point about additional check to be done by the backlog team when a new API submission is done: Correct wording is used in API description & Use-cases (example: no gateway word in UC !!)
Conclusion: OK from TSC for sandbox repository creation
IoT SIM Fraud Prevention API, supported by China Telecom.
New Sandbox proposed to solve IoT SIm Fraud use cases including 3 API proposals (to be aligned in API proposal):
Device to SIM Binding (IMEI) management
Device area restriction binding management
IoT fraud prevention
Original Issue #96; Templates: Device Area Restriction Device Card Binding. IoT SIM Fraud Prevention
@Herbert Damker : Question about RBAC (role based access control) could work with IoT - This should be part of the WG discussion
Conclusion: OK from TSC for sandbox repository creation
One API enhancement
Application Profile (for Connectivity Insight), proposed by Verizon
Participants and Description templates are now included in each API confluence page
Include descriptions as reported in CAMARA webpage (work in progress)
E.g.CallForwardingSignal API Description
Any update shall be communicated to backlog groups for updating the webpage accordingly
Will be included as deliverable in meta-release
Include participants of the repository
Each group and participant to get included.
APIs for incubation
CarrierBillingCheckOut ConnectivityInsights HomeDeviceQoD PopulationDensityData → not ready for incubation as not public statement of production deployment
Will be included post-spring25 as soon as they are ready, by:
Open a issue in backlog requesting for incubation
Backlog reviews the fulfillment of the requirements
Backlog requests TSC validation
Repo validated and status evolved.
Other topics
GSMA informed CAMARA Backlog that Open Gateway is considering certain Drop2/3/4 APIs that have been stuck in Backlog, “at risk”, due to lack of support. What this means is that GSMA is pushing our MNOs to actively reconsider within the next 2 weeks if they can support them. By raising it in the Backlog meeting we increase the chance to find enough support to “reactivate” progress.
Best Interconnect
IMEI Fraud API
For clarity if any API is not a priority for OGW anymore at this point in time, we still expect they can progress independently in CAMARA.
Updated API-onboarding guidelines including sandbox, incubated.. repositories and new WoW. PR approved, second phase with restructuring of content table (and split of API and repo lifecycle) ongoing:
Discussion
Current Issues
Issue # | Company | Summary | Status Update |
Centillion | New Proposal for Authorization for Advertisements, Advertisements Consent, and Measurement The API template is available in PR#73. | Published new standards, Next meeting (this time) Nick will bring all the documentation and present everything putted together The issue is not eligible to be closed yet. Pending to provide a concrete API description into the API proposal template Action: Clarifying with interested parties whether this may be a possible API or a Framework etc. AP: provide required information and examples LAST UPDATES: No response since October 8, 2024. MEETING UPDATE: Feb 27, 2025: not treated | |
TelecomsXChange | New Proposal: Carrier Wholesale Pricing The API template is available in PR#77 First YAML available here | The issue was not treated in this conference call The issue is not eligible to be closed yet. ACTION: Backlog Governance to reach up TelecomXchange to see if the could connect next meetings LAST UPDATES: No response for 6 months. MEETING UPDATE: Feb 27, 2025: not treated | |
Netfocusin Technologies | New Proposal: Steering of Roaming Management The API template is available in PR#78 | Does not seem to be in the Scope of Camara. Not an east-west (not between telcos) Already included in 3GPP as technical viable (provided in comment) The issue is not eligible to be closed yet. ACTION: Check for support/commitment from the partners (technical implementation approach important) LAST UPDATES: No response since May 10, 2024. MEETING UPDATE: Feb 27, 2025: not treated | |
China Mobile | 5G New Calling The API template is available PR#31 | Telefonica and Vodafone willing to see the presentation to check whether there is support for this To be treated in next session (still pending for providing extra info) Presentation of current proposal was shared in the meeting. Slides to be included in PR#31. @G. Murat Karabulut asked about the proposal been part of WebRTC enhancement or new API → new API. @Eric Murray asked about examples of 3rd parties in this API flow → app invoquing API to request or activate features, which can be enabled or not by the telco. @Mark Cornall raised the existance of a 5G New Calling project in GSMA: 5G New Calling & 5GNCTF Meeting#1 ACTION: Operators open to comment/ask for clarification and support the API. @Eric Murray asks for user stories that can explain the behaviour of the proposed API, as not clear how this interacts with the proper 5G New Calling standard and how it solves the features that are proposed. AP for @Haojie Li Branded Calls impact in WebRTC API · Issue #52 · camaraproject/WebRTC to discuss in WebRTC about relationship new information to be uploaded and treated in next session Recommendation is that China Mobile join regular WebRTC call to discuss 5G New Calling proposal there. LAST UPDATES: No response since June 11, 2024. MEETING UPDATE: Feb 27, 2025: not treated | |
MTN | New API proposal - IMEI Fraud The API template is available PR#64 | This API was presented already and included in an existing group but no work was done so discontinued. Now Rebecca is presenting the proposal seeking for support DeviceCheck GSMA proposal overlaps this IMEI Fraud will offer more information to developers than GSMA Device Check service. MTN and other supporters should meet with GSMA to discuss if proceeding with this API within CAMARA still makes sense. Request for meeting already sent by GSMA to MTN Outcome of meeting awaited before deciding if this API proposal should proceed in CAMARA
@Eric Murray : (IMEI status) service related, but GSMA is ok for this proposal. ACTION: Pending from MTN for moving on with this API. Maybe to be included in the Device Identifier family. @reg no further information from MTN, consider to de-prioritize, pending to further update Any other operator open to take the lead of this API is welcomed LAST UPDATES: No response since September 6, 2024. MEETING UPDATE: Feb 27, 2025: no treated | |
China Unicom | SIM Historical Information The API template is available in PR#114 | @Eric Murray comment: Sounds like a “historical SIM Swap” API. Discuss with SIM Swap sub-project. APs: China Unicom
LAST UPDATES: Feb 13, 2025: @Fan Yang to review issue offline and provide feedback and current status of the proposal. MEETING UPDATE: Feb 27, 2025: @Fan Yang no updates, will be reviewed in next meeting | |
China Unicom | User Account Spend Count The API template is available in PR#120 | MEETING UPDATE: Use case appears to be a KYC use case APs: China Unicom
LAST UPDATES: Feb 13, 2025: @Fan Yang to review issue offline and provide feedback and current status of the proposal. MEETING UPDATE: Feb 27, 2025: @Fan Yang no updates, will receive new in next meeting | |
China Unicom | Number Of Cards Under User's ID The API template is available in PR#119 | Use case appears to be a KYC use case APs: China Unicom
LAST UPDATES: Feb 13, 2025: For 115, 121, 122 information will be uploaded by @Fan Yang , issues to confirm with SIM Swap and KYC subprojects will be raised MEETING UPDATE: Feb 27, 2025: @Fan Yang no updates, news comming in next meeting
| |
China Unicom | Network Health Assessment The API template is available in PR#129 | EasyCLA to be solved LAST UPDATES: Feb 13, 2025: @Eric Murray could be considered as a new feature of the https://github.com/camaraproject/sessioninsights, more information is required from the Heath Score calculation. Use case are pretty similar, open whether the functionality is as well equal or requires an enhancement on current existing API. Gap analysis to be provided. AP: provide more information on the health score calculation, and whether this functionality can already fits within the Session Insight API (use cases). Gap analysis to be provided to find any extension possible to complete existing APIs with new functionality. MEETING UPDATE: Feb 27, 2025: difference from SessionInsight:
Proposal:
| |
China Unicom | Network Traffic Analysis The API template is available in PR#129 | EasyCLA to be solved LAST UPDATES: Feb 13, 2025: consider applicability in GitHub - camaraproject/ConnectivityInsights: Repository to describe, develop, document and test the Connectivity Insights family . @Eric Murray Main difference could be session/device granularity in the monitoring, but could be handled with existing session Insight API. GitHub - camaraproject/SessionInsights: Repository to develop the Quality by Design concept within the Connectivity Insights Sub Project AP: analyze current session/connectivity insight APIs to find posible gaps with network traffic proposal METING UPDATE: Feb 27, 2025: similar to Network Health Proposal:
| |
China Unicom | eSIM Remote Management The API template is available in PR#140 | Action for all China Unicom Topics: @Reg.cox will ask for an update from China Unicom in the next meeting LAST UPDATES: Feb 13, 2025:@Jan Friman some sequence diagrams will be good to understand the API proposal. AP: China unicom to upload additional information and flows of the API proposal. MEETING UPDATE: Feb 27, 2025: feedback received in https://github.com/camaraproject/APIBacklog/pull/140#issuecomment-2684562782. @Jorge Garcia Hospital need more information on the IF6 interface, whether this API is as well needed to be specified as a MNO interface to the app. @Tanja de Groot only for eSIM? yes, only eSIM profiles can be modified with this solution. Question about restricting the terminology, open for next meeting. | |
TIM | IoT Data Transfer Activation The API template is available in PR#144 | Focused on booking resources for a non-warranted connection for IoT, group of many devices at once, during a certain period. Not directly related to QoD or HighThroughput API. LAST UPDATES: Feb 13, 2025:@Kevin Smith posible overlap with Dedicated Network API (proposal), related to configure a network for a set of devices. To be reviewed. Issue#14 raised to discuss about posible overlap @fabrizio moggio : Proposal to include IoT API (separate repo) as part of the Dedicated Network “family” (share participants and meetings) to align use cases and definitions. @Jan Friman : this API looks like a specialization of Dedicated network API Proposal: To be proposed in the Dedicated network issue to validate Issue#14 TIM proposed an alternative approach to complement Dedicated Networks API, so that developer can manage energy modes, IoT slice selection os similar for a IOT device. @Tanja de Groot @Thorsten Lohmar proposed those features to be generic, not dedicated to IoT use cases Continue discussion with the new scope, including new API name. Dedicated network group will still be used to include the previous scope (scheduling a network config for IoT) New scope of API will be discussed separately. AP: modify current API proposal (PR and name) with new use cases (TIM) @fabrizio moggio will provide feedback of the status in the next backlog call
MEETING UPDATE: Feb 27, 2025: To be included in next TSC as all AP solved with IoT Network Optimization | |
China Unicom | Voice Notification The API template is available in PR#158 | LAST UPDATES: Feb 13, 2025: not treated METING UPDATE: Feb 27, 2025: proposal presented by @jincui, use cases related to notification launch over IMS channel for callers in device to receive and reach messaged (audio, text) @Jorge Garcia Hospital comment raised about the similarity or match with 5G new calling API proposal as targeted for applications to take advantage of the IMS network and callers. AP: To check PR#31 | |
China Unicom | Voice Verification Code The API template is available in PR#161 | LAST UPDATES: Feb 13, 2025: not treated MEETING UPDATE: Feb 27, 2025: proposal presented by @jincui, use case is focused on using the voice channel to send verification codes instead of by SMS. @Jorge Garcia Hospital comment raised about the similarity or match with 5G new calling API proposal as targeted for applications to take advantage of the IMS network and callers. AP: To check PR#31 AP for 157 &160 reach offline with china mobile to understand matching between APIs. | |
Telefonica | Dynamic Connectivity Data The API template is available in PR#164 | LAST UPDATES: Jan 21, 2025: @violeta.gonzalezfernandez@telefonica.com presented the topic, will check if it is going towards connectivity Insights group or QoD @Noel Wirzius asked to add for change of the name to bring “Prediction” in, and taking care of ground prediction as well Feb 13, 2025: not treated MEETING UPDATE: Feb 27, 2025: @Kevin Smith relation to connectivityInsight API in terms of checking connectivity available in the next future, difference is focus on this APis targeted to individual devices. No overlap expected. API to be proposed to TSC. | |
Cellcard | IdentityAndConsentManagement The API template is available in PR#166 | LAST UPDATES: Feb 13, 2025: not treated MEETING UPDATE: Feb 27, 2025: not treated |
Closing Issues
Issue # | Company | Summary | Status Update |
T-Mobile US | Capability and Runtime Restrictions
The API template is available in PR#74 | Approved for Sandbox repository Follow-up on API onboarding: [Onboarding Tracker] CapabilityAndRuntimeRestrictions · Issue #134 · camaraproject/APIBacklog | |
Totogi | New Proposal: Receive SMS
The API template is available in PR#75 |
Seems to fit in the SMS as a new scope enhancement The issue is not eligible to be closed yet. ACTION: Ricardo to formally proceed with the scope enhancement os the SMS group MEETING UPDATE:
| |
Deutsche Telekom | Best Interconnection
The API template is available in PR#88
Input from OGW Drop 3 | Seek for support ACTION: See if there is any overlap within EdgeCloud ACTION: Nick (centillion) to review with Noel (DT) about the match of use cases and consider support. DECISION API to be de-prioritised following de-prioritisation by OGW, but to remain in backlog. Issue to remain open. MEETING UPDATE: Not treated | |
Telefonica | New API proposal - Consent URL The API template is available PR#67 | The API proposal was presented, including additional slide info Discussion to follow offline in the issue/PR.
@Huub Appelboom supports API proposal @G. Murat Karabulut previously raised some concerns but seem clarified with last documentation. (uploaded in API PR#67 and also direct link) Pending: Proposal to be brought to TSC if no other concern is raised before end of week. MEETING UPDATE: under discussion in I&CM | |
Telefonica | Fixed Lines in Location The API template is available in PR#92 | METING UPDATE: Issue open in location API enhancement - Support of landlines · Issue #271 · camaraproject/DeviceLocation | |
Telefonica | Line Eligibility for Carrier Billing API The API template is available in PR#94 | MEETING UPDATE: Issue open in Carrier Billing API enhancement - Line Eligibility · Issue #190 · camaraproject/CarrierBillingCheckOut
| |
China Mobile | IP High-throughput Elastic Network The API template is available in PR#90 | Approved for Sandbox repository Follow-up on API onboarding: [Onboarding Tracker] HighThroughputElasticNetworks · Issue #133 · camaraproject/APIBacklog
| |
China Mobile | Facial Recognition The API template is available in PR#130 | EasyCLA to be solved METING UPDATE: material presented by YinMing Fu. @Eric Murray proposes in 126 to consider this API as part of already existing ModelAsA Service APi group (also from China Mobile) YinMing Fu considers API separated as MaaS focused on LLM models @Eric Murray raises issues on match with CAMARA authentication, privacy and identity existing mechanisms to be applied in this API @Jorge Garcia Hospital raised question on the telco capabilities been leveraged --> MNO face database is used AP to China Mobile to clarify open points
To modify the template to ScopeEnhancement of MaaS. @YinMing Fu updated PR#130 and API will be treated in next TSC 19th dec. 15:00 UTC METING UPDATE: Approved, pending to decide whether it will be part of same repo or different from MaaS | |
TIM | Energy Footprint Notification The API template is available in PR#142 | Approved: [Onboarding Tracker] Energy Footprint Notification · Issue #165 · camaraproject/APIBacklog | |
KDDI | QoS Booking The API template is available in PR#155 | Slide deck TSC UPDATE: QoS booking and current Dedicated Network APIs follow different use cases that need to be handled separately, proposal to create a separate sandbox repo to manage QoS Booking (related to QoD subproject). METING UPDATE: [Onboarding Tracker] QoS Booking · Issue #170 · camaraproject/APIBacklog | |
China Telecom | IoT SIM Fraud Prevention API The API template is available in PR#103 | @Jorge Garcia Hospital is it required to create a new set of APIs only for IoT devices or can they live in the existing groups? @Eric Murray agrees, device status can take in charge of this new parameters, check first with this subgroup GitHub - camaraproject/DeviceStatus: Repository to describe, develop, document and test the Device Status API family MEETING UPDATE: Meeting agreed with China Telecom that this proposal does not fit within Device Status sub-project APs: China Telecom
New proposal shared by@Moyuan Sun about SIM-Device binding change (possibly related to Device Swap) and area alerting (possibly related to Geofencing). Actions over lines are part of Device Management. China Telecom updates proposal in PR#103, keep offline discussion around Device Management. Opinion shared, that it could two different YAMLs. Check for TSC. MEETING UPDATE: TSC approval for next week, as separate sandbox (one for all the APIs proposed under this issue) as 3 APIs (with different internal features). | |
Verizon | Support application resource requirements in application profiles The API template is available in PR#110 |
@Mahesh Chapalamadugu presented this topic, asking for review until the next meeting METING UPDATE: Aligned with Connectivity Insight, to be confirmed in next TSC | |
TIM | Traffic Influence API - Sandbox repository TI API dedicated repository · camaraproject EdgeCloud · Discussion #313 | Approve the creation of a separated sandbox repository for Traffic Influence API, now under EdgeCloud repo. If no objection, tracker will be created accordingly. API and repo will be linked to EdgeCloud subproject. METING UPDATE: @fabrizio moggio explained that the Traffic influence API is ready to move into an own sandbox Agreed | |
China Telecom | IoT SIM Status Mgmt API The API template is available in PR#105 | Relationship with device management proposal, to confirm relationship. AP: China Telecom Meeting considered that this proposal has some overlap with the Device Management proposal from Verizon APs: China Telecom
@Moyuan Sun proposal to be modified to “communication capabilities” to avoid overlap with Device Management API proposal 50 Slides presented in the meeting (to be updated into the API proposal documentation) @Eric Murray @G. Murat Karabulut New proposal focused on the management of services of devices (activate/deactivate) but still in relation with Device Management concept @Mahesh Chapalamadugu (Verizon) to confirm if both proposals may still be merged AP: Email thread to be opened to provide a common position @Mahesh Chapalamadugu Action point verify the merge with Device Management for next meeting. MEETING UPDATE: Confirmed in: https://github.com/camaraproject/APIBacklog/issues/50#issuecomment-2642463127 APIs proposals PR to be updated before 17th EoB, and will be brought to TSC approval on 20th. | |
Verizon | Device Management The API template is available PR#30
| The issue was not treated in this conference call The issue is not eligible to be closed yet. Action to contact Verizon to ensure participation in next backlog meeting API proposal presented by @Mahesh Chapalamadugu , clarified this proposal is targeted for IoT device management to activate/deactivate/manage the connection of those devices. ACTION:@Mahesh Chapalamadugu to upload current yaml for clarification in PR#30, and present again in next meeting. @Mahesh Chapalamadugu AP to upload documentation Slides presented by @Mahesh Chapalamadugu & @joshua Slide will be uploaded and reviewed offline before approval ACTION: Review match with other Device management APIs (home devices or similar) and IoT/Device status (AP Backlog: contact Mahesh) Also ensure this is a proper telco capacity to be consumed by developers, in comparison with Operate API (TM Forum) that are related to Aggregators. METING UPDATE: Potential of merging IoT SIM Status Mgmt API in, will be checked by @Mahesh Chapalamadugu until next meeting. Confirmed in: https://github.com/camaraproject/APIBacklog/issues/50#issuecomment-2642463127 APIs proposals PR to be updated before 17th EoB, and will be brought to TSC approval on 20th. |
Review of Action Points
AP # | AP Owner | AP description | Related issue | Status |
20240523-01 | API Backlog Governance | Backlog Governance to reach up TelecomXchange & Netfocusin to see if the could connect next meetings | Open | |
20240711-04 | MTN/Chenosis | IMEI Fraud: Check the material shared by Eric/GSMA regarding DeviceCheck, and validate the inclusion of the API in the Device Identifier group
Meeting Update: Waiting for more updates, any other operator open to join | Open | |
20240926-03 | China Mobile | 5G New Calling
| Open | |
20241010-02 | ALL | IMEI Fraud
| Open | |
20250109-01 | TIM | IoT Data Transfer Activation Modify current API proposal (PR and name) with new use cases (TIM) | Open | |
20250123-03 | TEF/DT | Dynamic Connectivity Data Modify current API proposal according to comments. | Open | |
20250213-01 | ALL | Review:
| N/A | Closed |
20250213-02 | China Unicom | SIM Historical Information @Fan Yang Review issue offline and provide feedback and current status of the proposal. | S | |
20250213-03 | China Unicom | User Account Spend Count @Fan Yang Review issue offline and provide feedback and current status of the proposal. | Closed | |
20250213-04 | China Unicom | Number Of Cards Under User's ID For 115, 121, 122 information will b uploaded by @Fan Yang , issues to confirm with SIM Swap and KYC subprojects will be raised | Closed | |
20250213-05 | China Unicom | Network Health Assessment Provide more information on the health score calculation, and whether this functionality can already fits within the Session Insight API (use cases). Gap analysis to be provided to find any extension possible to complete existing APIs with new functionality. | Open | |
20250213-06 | China Unicom | Network Traffic Analysis Analyze current session/connectivity insight APIs to find posible gaps with network traffic proposal
| Open | |
20250213-07 | China Unicom | eSIM Remote Management China unicom to upload additional information and flows of the API proposal. Update: include more information on interfaces to included in the proposal (e.g. IF6)
| Open updated 02-27 | |
20250227-01 | China Unicom | Voice Notification & Voice Verification Code China Unicom to review possible match with 5G New Calling API proposal PR#31 | Open | |
|
|
|
|
|
Decision Points
DP # | DP description | Status |
|
|
|
AoB
N/A
Q&A
How does CAMARA API pipeline work?
The pipeline consists of FOUR stages:
A. Submission of the API proposal.
B. Evaluation of the API proposal.
C. API proposal voting & decision.
D. Sub-Project setup.
The following clauses provides details on individual stages.
Stage A: Submission of the API proposal
Participants: API owner.
Description: The process is detailed here. To proceed with the submission, the API owner shall follow these steps:
Fill in the template available here and save it with the following name: "APIproposal_<APIname>_<owner>. md" locally.
Create a new issue in the API Backlog Working Group repository, labeled with "API Backlog".
Upload the filled-in template to GitHub repository folder for API proposals via Pull Request. This Pull Request shall be associated to the issue created in the previous step.
Stage B: Evaluation of the API proposal
Participants: API owner, API backlog WG.
Description: The process is detailed here. Upon submission, the API owner will present the proposal in the next API backlog WG meeting, to socialize it with the rest of partners. In parallel..
The WG chair checks that the template is duly filled in. Otherwise, the API owner is requested to provide missing information.
After this sanity check, each WG participant declares their support. If a company wants to become supporter of an API, then a delegate of this company needs to add the company's name in the 'supporters' column in the API backlog table. The more support an API proposal gets, the better (it may get more traction).
When the API owner considers the API proposal is in good shape to go for approval, it informs the WG chair accordingly.
Upon receiving this information, the WG chair merges the Pull Request into the main branch, and sends the API proposal to the Technical Steering Committee (TSC) of CAMARA. This action shall be completed at least one week prior to the TSC meeting where the API proposal will be voted upon.
The whole procedure (steps 1-4) should be done within 2 regular meetings of the API Backlog WG. Nonetheless, it is up to the API owner to decide if it wants to shorten or extend this time period.
Stage C: API proposal & voting decision
Participants: TSC.
Description: The process is detailed here. Upon receiving the API proposal and notification from the API backlog WG chair, the TSC studies the proposal and votes it at the next TSC meeting.
NOTE 1: Possible decisions outcomes:
Not Accepted: The API proposal is rejected, and thus will not be included in any API Sub-Project. The TSC will need to inform the API backlog WG of this decision, and clarify next steps: either (1) remove this API proposal from backlog, with objecting companies providing justifications why; or (2) ask for changes (e.g., clarifications, corrections, gaps to be addressed) required in order for the API to be re-submitted by the API supporters.
Accepted: In this case, the TSC shall specify whether the API proposal is to be hosted by a new or existing Sub Project.
NOTE 2: The TSC may also propose changes to an API proposal and take the decision considering these changes. The TSC documents the decision in the CAMARA API overview list (fills in columns TSC date and TSC decision / Sub Project; in case of a No-Go "Rejected" is documented there).
Stage D: Sub-Project setup
Participants: API backlog WG, TSC, CAMARA admin team
Description: If an API proposal is accepted and there is a need to open a new Sub-Project, the following steps are needed:
Supporting companies propose their initial maintainers to be added for the Sub-Project. The API backlog WG chair centralizes this information, and sends it to the TSC.
The TSC will use this input to officially nominate the initial maintainers by next TSC meeting.
The CAMARA admin team creates the Sub-Project repository.
NOTE: After the initial maintainers are nominated, the criteria for further maintainers would be three months of active contribution to the sub project. Code owners are to be decided by the maintainers within the subproject.