Catalog

The Catalog page displays the documentation for your APIs, organized by product.

Follow the steps below to download a swagger file.

  1. Access your Developer Portal.
    Go directly to the link or access the Portal Manager and click Portal  Appearance to get the link.

  2. Click APIs  Catalog in the top right corner of the screen.
    You must be logged in.

    detail of the developer portal header with an indication of the link to the catalog

  3. Select the desired product.
    If necessary, use the search field by API or the product filter.

  4. Click the API’s DOCUMENTATION button.
    The images below are for illustrative purposes only. Colors, logos, and other elements may vary depending on the customization made in Portal > Appearance of the Portal Manager.

    detail of the developer portal product screen and documentation button

  5. In the top right section, select the document revision and click DOWNLOAD SWAGGER.

    detail of the catalog screen with document revision and download button options

Accesses

To view the documentation for an API in the catalog, it is necessary:

  1. that the API Catalog route is defined in at least one role;

  2. that the product and the API are defined with this role;

  3. that the user has a role with characteristics 1 and 2.

Administrator, if a user does not see a product or API in the API catalog, verify:

Registering and editing roles for a product

Administrator, follow these steps to define which roles can access the API Catalog:

  1. In the Portal Manager, click Products, located in the left side menu or on the home screen.
    home screen with products highlighted

  2. Click the pencil icon for the product you want to edit.

  3. In Roles, select the roles that will have access to the API catalog products.
    step 1 of product registration with roles highlighted

Thanks for your feedback!
EDIT

Share your suggestions with us!
Click here and then [+ Submit idea]