Skip to content

Conversation

@jafilippini1
Copy link
Contributor

@jafilippini1 jafilippini1 commented Jun 2, 2025

Adding Sponsored Data API proposal - Telecom Argentina

New API Proposal: #223

  • documentation

Which issue(s) this PR fixes:

Fixes #223

Adding Sponsored Data API proposal - Telecom Argentina
@linux-foundation-easycla
Copy link

linux-foundation-easycla bot commented Jun 2, 2025

CLA Signed

The committers listed above are authorized under a signed CLA.

@albertoramosmonagas
Copy link
Contributor

Hi @jafilippini1, before attending the API backlog WG meeting and submitting the API, please check for the “is not authorized under a signed CLA” error. Just click on the link to verify yourself as a user.

| API family name | Sponsored Data |
| API family owner | Telecom Argentina S.A. |
| API summary | The Sponsored Data API enables enterprises to sponsor mobile data traffic for specific subscribers, allowing them to access the internet or use applications without consuming their own data allowance.<br><br>This first version of the API is designed for ANY-destination sponsorship, meaning all traffic generated by the user during a sponsorship session is zero-rated. This approach ensures simple implementation and broad applicability across diverse use cases.<br><br>Sponsorship applies to a predefined volume of traffic and for a determined time period, ensuring controlled usage according to the campaign parameters.<br><br>The API may be extended in future iterations to support targeted sponsorship by destination (e.g., domain, IP, service), allowing operators to restrict sponsorship to specific digital services. |
| Technical viability | This initial version of the Sponsored Data API is technically viable in networks that support the provisioning of secondary data offers (Free Units) with zero rating through the Online Charging System (OCS).<br><br>The implementation assumes a sponsorship model based on ANY-destination, meaning no DPI or destination-specific control is required. Therefore:<br><br>The API only requires that the OCS can handle multiple concurrent data balances per subscriber, and apply 0-rating to the sponsored volume.<br><br>Real-time enforcement of the Free Unit usage is handled mainly by the OCS, without the need for complex or customized PCRF/PCF rules.<br><br>An internal API Gateway (APIGW) interfaces with the OCS to initiate and revoke the sponsored offer using secure APIs.<br><br>The solution is compatible with 3GPP Rel-13 and above, assuming basic support for OCS-based data rating and quota management.
Copy link
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Let's avoid such technical language, I invite you to review the description and if we use acronyms, define them before, for example, in this context, what is DPI?

Copy link
Contributor Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Hi Alberto,
Thanks for your comments.

I have a quick question: since I’m contributing with this proposal on behalf of Telecom Argentina, I assume I need to be authorized as a Corporate CLA Contributor, right? Or would it also be valid to sign as an Individual Contributor, even if I’m representing Telecom?

Also, regarding your feedback on the document I uploaded, I understand your comments — I’ll revise it to remove the technical jargon and ensure all acronyms are defined before use.

Lastly, I’ll upload the API’s YAML file to the “documentation” repository from my side, so everything is ready to move forward as soon as I’m authorized under the CLA.

Thanks again.

Julián

Copy link
Collaborator

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

since I’m contributing with this proposal on behalf of Telecom Argentina, I assume I need to be authorized as a Corporate CLA Contributor, right? Or would it also be valid to sign as an Individual Contributor, even if I’m representing Telecom?

@jafilippini1 Your assumption is correct, you have to be covered under a CCLA, afaik Linux Foundation is not accepting ICLA for accounts which are affiliated with a company. If you have further questions about EasyCLA you can contact the LF team via support@camaraproject.org (cc: @wrathwolf)

Section Technical viability was modified taking off technical terms.

Related to issue camaraproject#223
@albertoramosmonagas
Copy link
Contributor

Hi @jafilippini1,

I just wanted to check if you or someone of Telecom Argentina is planning to join one of the upcoming backlog sessions to present the Sponsored DATA API. Since it was first proposed, we’ve already had two sessions, so it would be great if you could come by and share it with the other telcos.

@jafilippini1
Copy link
Contributor Author

Hi @albertoramosmonagas, thanks for your message.
Yes, we do want to present our proposal to the telco community, but we thought that signing the CLA agreement was a prerequisite.
Next week is a bit busy for us, but we would be available to present the API proposal starting from the following week, whenever it suits you.
By the way, is there a presentation template typically used for these kinds of presentations that you could share with us?
Finally, regarding the CCLA signing, we are currently in that process as well.
BR.
Julián

@albertoramosmonagas
Copy link
Contributor

Hi @albertoramosmonagas, thanks for your message. Yes, we do want to present our proposal to the telco community, but we thought that signing the CLA agreement was a prerequisite. Next week is a bit busy for us, but we would be available to present the API proposal starting from the following week, whenever it suits you. By the way, is there a presentation template typically used for these kinds of presentations that you could share with us? Finally, regarding the CCLA signing, we are currently in that process as well. BR. Julián

Great, in theory the CLA is for the PRs and any code you plan to upload to GitHub.

To access the backlog meetings, you just need to use this link:

Meeting Cadence:

Mailing List

The next meetings are on July 10 and July 24.

Regarding the template, there isn’t any specific one—you can simply use whatever you have internally to present the scope of this API.

We are here for you!

@hdamker
Copy link
Collaborator

hdamker commented Jun 29, 2025

Regarding the template, there isn’t any specific one—you can simply use whatever you have internally to present the scope of this API.

If you would like to use a neutral powerpoint template from CAMARA you can go with this one: https://github.com/camaraproject/Marketing/blob/main/documentation/MarketingMaterial/CAMARA%20Master%20Template.potx. But as @albertoramosmonagas already wrote, there is no need to use it.

@jafilippini1
Copy link
Contributor Author

Hi Alberto and Herbert,

Thank you for your response.

We are planning to present the scope of our API proposal on July 10, if that date is still available. Could you please confirm if it works for you?

Also, should we send our presentation in advance to someone to be included in a larger deck, or will we present it directly from our own laptops on that day?

Lastly, we understand that we can join directly using the provided link, without any prior registration. Could you please confirm this as well?

Best regards,
Julián

@albertoramosmonagas
Copy link
Contributor

Hi Alberto and Herbert,

Thank you for your response.

We are planning to present the scope of our API proposal on July 10, if that date is still available. Could you please confirm if it works for you?

Also, should we send our presentation in advance to someone to be included in a larger deck, or will we present it directly from our own laptops on that day?

Lastly, we understand that we can join directly using the provided link, without any prior registration. Could you please confirm this as well?

Best regards, Julián

Hello!

great, backlog meetings are recurring every two weeks. If they are recorded in these meetings they are automatically triggered and always (as long as nothing unusual happens) will be done. So there is no problem with you presenting the API on July 10.

Regarding the presentation, having it uploaded in the Proposal PR would be enough, but it can be uploaded after submitting the API in the backlog meeting. On that day it would be enough to submit it directly from your own laptops.

To join the session is by zoom. Once you are registered you should not encounter any problems. However, you can join 10 minutes before the session to test that everything works correctly.

Best regards

@jafilippini1
Copy link
Contributor Author

Hi Alberto,
Just to confirm that we plan to present the Sponsored Data API next Thursday.
We will present directly from our laptops.
Is this message enough to confirm our participation, or should we notify someone else by email as well?
Best regards,
Julián

@albertoramosmonagas
Copy link
Contributor

Hi Alberto, Just to confirm that we plan to present the Sponsored Data API next Thursday. We will present directly from our laptops. Is this message enough to confirm our participation, or should we notify someone else by email as well? Best regards, Julián

Hi Alberto, Just to confirm that we plan to present the Sponsored Data API next Thursday. We will present directly from our laptops. Is this message enough to confirm our participation, or should we notify someone else by email as well? Best regards, Julián

Great, see you on Thursday 10th at the backlog meeting, that's all it takes. Thank you very much for your response.

Try to fix the EasyCLA in view of the meeting, which is the first item to come out of the session!

Thanks!

@jafilippini1
Copy link
Contributor Author

jafilippini1 commented Jul 8, 2025

Hi Alberto,

Thanks for your response.

Understood — we’ll proceed to sign the CLA in the coming days, and will reschedule our presentation for after that step.

Best regards,
Julián

@jafilippini1
Copy link
Contributor Author

Hi team,
We’ve already completed and signed the CLA agreement. We would really appreciate it if you could take a look at the YAML file for our proposed API: Sponsored Data.
We hope to be able to present it with you during the next API Backlog meeting call .
Thanks!,
Julián

@jafilippini1
Copy link
Contributor Author

Hi team,
Here’s the Sponsored Data API PowerPoint presentation file for reference.
Thanks,
Julián
Sponsored Data API - Presentation.pptx

Hi team,  
Here is the "Sponsor_Data_API.v1.yaml" file for reference.  

Thanks,  
Julián
Hi team,  
Here is the "Sponsored Data API" PowerPoint presentation file for reference.  

Thanks,  
Julián
@jafilippini1
Copy link
Contributor Author

Hi team,
I have uploaded in this PR both files: API YAML and Power Point Presentation.
BR.
Julián

@jafilippini1
Copy link
Contributor Author

Hi @Noel-Wirzius-DT @caubut-charter @eric-murray @jgarciahospital,
when you have a moment, I’d really appreciate your review of this API proposal so we can move forward with the merge.
Thanks a lot for your time and feedback!

Copy link
Collaborator

@jgarciahospital jgarciahospital left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM

@jgarciahospital jgarciahospital merged commit b91626d into camaraproject:main Sep 3, 2025
1 check passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

None yet

Development

Successfully merging this pull request may close these issues.

New API Proposal - Sponsored Data

6 participants