Configure Public API

This section describes how to enable Public API in API Portal in API Manager and Joomla! Administrator Interface (JAI).

Configure exposing APIs and applications in API Manager

Public API relies on how API Catalog and organizations are configured in API Manager. For Public API access, you must create a separate organization with a default user, and expose back-end APIs and applications to that organization.

  1. In API Manager, add a new organization called, for example, Public API Org.
  2. Add a user account for Public API access. Ensure you do the following:
    • Enable the user.
    • Set Organization to the Public API organization you created (Public API Org)
    • Set Role to User.

    The rest of the mandatory values must be set, but the exact values are not important.

  3. Select Change password, and set the password for the default user.
  4. Tip   Make a note of the login name and password you configure for the Public API user. You need them later when configuring the Public API access in JAI.
  5. To expose APIs in Public API, go to Frontend API, select the APIs you want to expose, click Managed selected > Grant access, set Grant API access to The following organizations, and add and select your Public API organization.
  6. Tip   You can import two versions of a back-end API: one that contains only non-business critical information and is exposed in Public API, and a full version which is not exposed without a user login.
  7. To expose applications in Public API, go to Clients > Applications, ensure that the organization of the applications is set to your Public API organization and the application has access to the required APIs, then share the application with the Public API user you created. It is recommended to only provide rights to view the application.

For more details on working in API Manager, see the API Manager User Guide.

Enable Public API in API Portal

Public API is disabled by default. You must enable it in JAI, and add the login details of the Public API user account you created in API Manager.

  1. Log in to JAI, and go to Components > API Portal.
  2. Under Public API Settings, set Enable Public API to Yes.
  3. In Public API Account Login, enter the login name of the Public API user account you created.
  4. In Public API Account Password, enter the password of the Public API user account you created, and click Save.
  5. To test Public API, go to your API Portal landing page. You should now see the Explore button instead of the Sign In button, and be able to access the APIs you have exposed for Public API in API Manager.

If you still see Sign In button after enabling, check you have used the correct credentials when configuring the account details in JAI.

Disable testing API methods in Public API

If you want, you can disable the Try it functionality in Public API.

  1. In JAI, click Menu(s) > Main Menu.
  2. Select APIs.
  3. On the API Catalog tab, set Show inline Try-it to Yes only to authenticated users, and click Save.

Related Links