Skip to content
Snippets Groups Projects
Commit 27373950 authored by torrespel's avatar torrespel
Browse files

added enhanced_event_report

parent d547341e
No related branches found
No related tags found
1 merge request!28Resolve "API Status Documentation"
...@@ -5,16 +5,14 @@ The API Status feature, introduced in the 3GPP Common API Framework (CAPIF) tech ...@@ -5,16 +5,14 @@ The API Status feature, introduced in the 3GPP Common API Framework (CAPIF) tech
This feature in OpenCAPIF provides real-time insights into the operational status of APIs, enabling stakeholders to quickly determine whether an API is functioning as expected. By improving API availability tracking, it helps users make more informed decisions about integration and usage. This feature in OpenCAPIF provides real-time insights into the operational status of APIs, enabling stakeholders to quickly determine whether an API is functioning as expected. By improving API availability tracking, it helps users make more informed decisions about integration and usage.
## How it works ## How it works
This new functionality is found in two CAPIF services, the publish service and the events service.
This new functionality is found in two CAPIF services, the publication service and the events service.
### Publish service ### Publish service
The API Status in the publish service allows providers to show in which AEFs the published API is available.
The API Status in the publishing service allows providers to show in which AEFs the published API is available.
In order to use the API Status, it is necessary to have ApiStatusMonitoring enabled in supportedFeatures when publishing an API. With this enabled, we can use the publication's apiStatus, which is composed of a list of AEF identifiers in which the API is available. In order to use the API Status, it is necessary to have ApiStatusMonitoring enabled in supportedFeatures when publishing an API. With this enabled, we can use the publication's apiStatus, which is composed of a list of AEF identifiers in which the API is available.
This gives us 3 options for displaying the status of an API: This gives us 4 options for displaying the status of an API:
- If the apiStatus contains a list of aefIds, the api will be **available** on all aefs in the list. - If the apiStatus contains a list of aefIds, the api will be **available** on all aefs in the list.
- If the apiStatus contains an empty list of aefIds it means that the API is **NOT available** in any AEF. - If the apiStatus contains an empty list of aefIds it means that the API is **NOT available** in any AEF.
...@@ -24,12 +22,11 @@ This gives us 3 options for displaying the status of an API: ...@@ -24,12 +22,11 @@ This gives us 3 options for displaying the status of an API:
If ApiStatusMonitoring is not supported and apiStatus is used to show API availability, a 400 error will be returned. If ApiStatusMonitoring is not supported and apiStatus is used to show API availability, a 400 error will be returned.
### Events service ### Events service
The API Status within the Events service provides critical insights into the availability of subscribed services.
The Status API within the Events service provides critical insights into the availability of subscribed services.
Both API Invokers and Providers can subscribe to the **SERVICE_API_AVAILABLE** and **SERVICE_API_UNAVAILABLE** events to receive timely notifications about the operational status of an API, whether it becomes available or unavailable. Both API Invokers and Providers can subscribe to the **SERVICE_API_AVAILABLE** and **SERVICE_API_UNAVAILABLE** events to receive timely notifications about the operational status of an API, whether it becomes available or unavailable.
Furthermore, if the apiStatusMonitoring feature is enabled in the supportedFeatures, the notifications will include not only the API ID indicating its availability but also a description of the API itself, offering more comprehensive context for improved decision-making. Additionally, if the enhanced_event_report function is supported, the API description could be received as event details in the eventDetails field if apiStatusMonitoring is also enabled. This will make it easier for event subscribers to know if any changes have been made to the API, such as a change in API availability to other AEFs.
[OCF Web]: https://ocf.etsi.org/ "OCF Web" [OCF Web]: https://ocf.etsi.org/ "OCF Web"
......
0% Loading or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment