Why I cannot view the API Endpoint tab on API Portal properly?

Introduction

This guide introduces why developers will encounter error when they view the API Endpoint tab on API Portal. The error might be caused by:

1. Browser not compatible
2. Swagger Configuration issue

Browser Compatibility

Browser Compatibility Overview

FabriXAPI Web Apps are built for browsers based on Chromium. Technically, any browser that uses Chromium should be able to run FabriXAPI Web Apps. Currently, FabriXAPI team is focusing on Chrome and Safari browsers, which have a market share of 60%+ and 25%+, respectively. The Web Apps will be tested on the latest versions of Chrome and Safari at the time a specific version of FabriXAPI is released. For the Public SaaS version of FabriXAPI, the Web App will support the latest two versions of Chrome and Safari browsers.

About Mobile Support

Due to the technical nature of FabriXAPI, mobile support is not the main focus of the platform. The platform provides best-effort mobile support for the FabriXAPI Web App, as it is public-facing. However, the Developer Admin Portal, Provider Admin Portal, and Operator Portal do not support mobile browsers by default.

About FabriXAPI Enterprise Edition

For users of FabriXAPI Enterprise Edition, it's possible that the version may not be as up-to-date as the public SaaS version, depending on the operator's policy. The browser compatibility will be based on the two most recent versions of Chrome and Safari at the time of a specific Enterprise Edition release.

About UI Defects in Web Browsers

If you encounter any UI issues in your browser, please report them to us via oah-support@openapihub.com. We will evaluate the impact and propose a workaround whenever possible.

What can I do if my browser is not compatible?

1. Update your Browser
   Visit the official website of your browser (e.g., Chrome, Safari) and download the latest version. Install the update and relaunch the browser.

2. Clear Cache and Cookies
   Clearing the cache and cookies of your browser can help resolve display issues caused by cached data. Go to the browser settings and locate the option to clear cache and cookies. After clearing, reload FabriXAPI webpage.

3. Disable Browser Extensions
   Some browser extensions can interfere with the proper rendering of webpages. Disable any extensions that might be causing conflicts and reload FabriXAPI webpage.

4. Try a Different Browser
   If the issue persists, try accessing FabriXAPI webpage using a different browser. This will help determine if the problem is specific to your current browser.

If none of the above steps resolve the issue, please contact the support team via oah-support@openapihub.com for further assistance.

What can I do if encounter Swagger Configuration issue?

If FabriXAPI webpage is not displaying any information or showing incorrect data, the issue might be related to the Swagger configuration. Follow the steps below to troubleshoot the problem:

1. Check API Provider Documentation
   Refer to the API provider's documentation or contact their support team to ensure that the API is correctly configured and accessible.
2. For API Provider: Verify Swagger Configuration
   Check if the Swagger configuration for the API is correctly set up. Ensure that the API definition and documentation are accurately defined in the Swagger file.
3. For API Provider: Validate Swagger File
   Use a Swagger validation tool or an online Swagger editor to validate your Swagger file. This will help identify any syntax errors or missing information in the Swagger file.

Please also refer to the user guide for Upload Swagger