Hello Daniel,
So I do not speak for the TMF API team or the TMF but in my experience.
Most CSPs in terms of developer on boarding and support would tend to use the developer portal and tools associated with their API management portals.
In terms of exposing APIs as micro-applications I suspect most would point various web resources already out there. I am not sure the TMF has a particular take on micros services and web apps per se.
The only things I would say is that if you are exposing the TMF APIs from your internal systems to external users you might want to think of the following points.
1) Are all the operations supported by the API valid for external use?
2) Is all the data exposed via the API intended for the end user and would they understand what they are being shown?
3) How does an end user navigate from the use of one API to another as part of a user journey?
4) If there is composition and orchestration be careful not to expose that as client side logic which could be hacked by the end user (instead do your composition, orchestration and filtering server side and expose a different API to the client rather than the TMF APIs).
------------------------------
Derrick Evans
------------------------------
Original Message:
Sent: Jan 13, 2022 13:58
From: DANIEL SOEIRO SANTOS
Subject: Tenants Portal
Thanks Derrick . One of deliverables, is to expose the applications to end users as a simple set of micro-applications. The idea is create applications for various journeys and exposed these via web pages. Anyway , I imagined that OpenAPI project could share a best approach to establish it. If not each CSP will implement it by on its own . In addition , we also have to expose the Api's to support developers to help understand . If there is not a best approach aligned with OpenAPI project each CSP will implement it by on its own too . In this case, as you mentioned, I will see Azure API Management developer portals to take the APIs .
Thanks in advance,
------------------------------
DANIEL SOEIRO SANTOS
Telefonica Brasil S.A.
Original Message:
Sent: Jan 13, 2022 07:44
From: Derrick Evans
Subject: Tenants Portal
Hello Daniel
Is the portal intended to support developers to help understand your APIs better?
Or is the intention to expose the applications to end users as a simple set of micro-applications?
Platforms like Azure API Management have developer portals to take the APIs and expose sandboxes and other tools so that should cover the first use case.
If the intention is the second use case then I am not sure a naked exposure of the APIs as they are is that useful.
Some APIs (like a premises look up) map quite well to a single API if users just want to look up an address.
But many others need to be orchestrated into customer experiences using some form of server side service.
In a past engagement, we did create a portal that exposed a web page for each API but customer feedback suggested that users wanted to be guided through a journey one or two API calls at a time starting with premises location on to product qualification and then into ordering. To do that we decided to maintain the logic and state server side and not orchestrate these calls in the browser. So we created applications for various journeys and exposed these via web pages.
------------------------------
Derrick Evans
Original Message:
Sent: Jan 12, 2022 15:48
From: DANIEL SOEIRO SANTOS
Subject: Tenants Portal
Hi Jonathan , I hope you're fine and thanks for reply my message . We've a deliverable to implement a user interface (UI) called "Portal dos Tenants" to somebody operate the API's using a friendly front-end but I don't know if there is or there isn't a good practice to expose, implement it .
Please find attached some idea where I've highlighted my doubt. Should we implement internal system using a friendly front-end to expose it or is recommended implement a specific interface, tool , fields , etc aligned with Open API Tmforum project? Please let me know if now it's clear or not. Thanks in advance.
------------------------------
DANIEL SOEIRO SANTOS
Telefonica Brasil S.A.
Original Message:
Sent: Jan 12, 2022 15:05
From: Jonathan Goldberg
Subject: Tenants Portal
Hi Daniel
I'm afraid that I don't really understand your question. What do you mean by "Tenants Portal"?
Is your organization interested in developing software to implement Open APIs, or perhaps to consume Open APIs from vendor software, or both?
Additional context information would be useful to help the community help you.
------------------------------
Jonathan Goldberg
Amdocs Management Limited
Any opinions and statements made by me on this forum are purely personal, and do not necessarily reflect the position of the TM Forum or my employer.
Original Message:
Sent: Jan 11, 2022 07:59
From: DANIEL SOEIRO SANTOS
Subject: Tenants Portal
Is there any default prototype to establish the Tenants Portal to expose and operate the Open API's ? Example below ,
------------------------------
DANIEL SOEIRO SANTOS
Telefonica Brasil S.A.
------------------------------