Skip to content
Snippets Groups Projects
Commit 909d6edf authored by Jorge Moratinos's avatar Jorge Moratinos
Browse files

Deployed e2d29213 to develop in public with MkDocs 1.6.1 and mike 2.1.3

parent 2cff4dd2
No related branches found
No related tags found
No related merge requests found
Expand all Hide whitespace changes
Inline Side-by-side
public/develop/api-status/api-status/index.html
+ 123
− 1
View file @ 909d6edf
......@@ -468,6 +468,17 @@
<label class="md-nav__link md-nav__link--active" for="__toc">
<span class="md-ellipsis">
Api Status
</span>
<span class="md-nav__icon md-icon"></span>
</label>
<a href="./" class="md-nav__link md-nav__link--active">
......@@ -478,6 +489,58 @@
</a>
<nav class="md-nav md-nav--secondary" aria-label="Table of contents">
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#how-it-works" class="md-nav__link">
<span class="md-ellipsis">
How it works
</span>
</a>
<nav class="md-nav" aria-label="How it works">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#publish-service" class="md-nav__link">
<span class="md-ellipsis">
Publish service
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#events-service" class="md-nav__link">
<span class="md-ellipsis">
Events service
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</li>
......@@ -824,6 +887,47 @@
<label class="md-nav__title" for="__toc">
<span class="md-nav__icon md-icon"></span>
Table of contents
</label>
<ul class="md-nav__list" data-md-component="toc" data-md-scrollfix>
<li class="md-nav__item">
<a href="#how-it-works" class="md-nav__link">
<span class="md-ellipsis">
How it works
</span>
</a>
<nav class="md-nav" aria-label="How it works">
<ul class="md-nav__list">
<li class="md-nav__item">
<a href="#publish-service" class="md-nav__link">
<span class="md-ellipsis">
Publish service
</span>
</a>
</li>
<li class="md-nav__item">
<a href="#events-service" class="md-nav__link">
<span class="md-ellipsis">
Events service
</span>
</a>
</li>
</ul>
</nav>
</li>
</ul>
</nav>
</div>
</div>
......@@ -838,7 +942,25 @@
<h1 id="api-status-feature">API Status Feature</h1>
<p>DOC:Work in Progress</p>
<p>The API Status feature, introduced in the 3GPP Common API Framework (CAPIF) technical specifications starting from Release 17, offers significant enhancements for operators and developers.</p>
<p>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.</p>
<h2 id="how-it-works">How it works</h2>
<p>This new functionality is found in two CAPIF services, the publish service and the events service.</p>
<h3 id="publish-service">Publish service</h3>
<p>The API Status in the publish service allows providers to show in which AEFs the published API is available.</p>
<p>In order to use the API Status, it is necessary to have <em>apiStatusMonitoring</em> 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.</p>
<p>This gives us 4 options for displaying the status of an API:</p>
<ul>
<li>If the apiStatus contains a list of aefIds, the api will be <strong>available</strong> on all aefs in the list.</li>
<li>If the apiStatus contains an empty list of aefIds it means that the API is <strong>NOT available</strong> in any AEF.</li>
<li>If the apiStatus is not used, it is understood that the api is <strong>available</strong> in all AEFs of the aefProfiles.</li>
<li>If the <em>apiStatusMonitoring</em> was not supported, the api would be <strong>available</strong> in all AEFs in the aefProfiles.</li>
</ul>
<p>If <em>apiStatusMonitoring</em> is not supported and apiStatus is used to show API availability, a 400 error will be returned.</p>
<h3 id="events-service">Events service</h3>
<p>The API Status within the Events service provides critical insights into the availability of subscribed services.</p>
<p>Both API Invokers and Providers can subscribe to the <strong>SERVICE_API_AVAILABLE</strong> and <strong>SERVICE_API_UNAVAILABLE</strong> events to receive timely notifications about the operational status of an API, whether it becomes available or unavailable.</p>
<p>Additionally, if the <em>enhanced_event_report</em> function is supported, the API description could be received as event details in the eventDetails field if <em>apiStatusMonitoring</em> 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.</p>
......
public/develop/search/search_index.json
+ 1
− 1
View file @ 909d6edf
This diff is collapsed.
public/develop/sitemap.xml
+ 26
− 26
View file @ 909d6edf
......@@ -2,106 +2,106 @@
<urlset xmlns="http://www.sitemaps.org/schemas/sitemap/0.9">
<url>
<loc>https://ocf.etsi.org/develop/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/FAQ/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/architecture/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/releasenotes/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/api-status/api-status/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/contribute/documenting/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/example-clients/example-clients/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/gettingstarted/howtorun/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/gettingstarted/repository/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/sdk/sdk/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/testing/postman/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/testing/robotframework/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/testing/testplan/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/testing/testplan/api_access_control_policy/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/testing/testplan/api_auditing_service/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/testing/testplan/api_discover_service/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/testing/testplan/api_events_service/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/testing/testplan/api_invoker_management/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/testing/testplan/api_logging_service/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/testing/testplan/api_provider_management/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/testing/testplan/api_publish_service/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/testing/testplan/api_security_service/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/testing/testplan/api_status/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/testing/testplan/common_operations/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/testing/testplan/vendor_extensibility/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
<url>
<loc>https://ocf.etsi.org/develop/vendor-ext/vendor-ext/</loc>
<lastmod>2025-01-21</lastmod>
<lastmod>2025-01-22</lastmod>
</url>
</urlset>
\ No newline at end of file
public/develop/sitemap.xml.gz
+ 0
− 0
View file @ 909d6edf
No preview for this file type
0% or .
You are about to add 0 people to the discussion. Proceed with caution.
Finish editing this message first!
Please register or to comment