API Category based Grouping¶
You can use API categories to group APIs. API categories do not use a naming convention. Therefore, the admin does not need to take into consideration any naming conventions when using API category based grouping.
Initially, the Admins will define API categories. Thereafter, API providers will add API categories to APIs when designing them via the API Publisher. API categories allow API providers to categorize APIs that have similar attributes. When a categorized API gets published to the Developer Portal, its categories appear as clickable links to the API consumers. The API consumers can use the available API categories to quickly jump to a category of interest.
Step 1 - Add an API Category¶
You can add an API category using any of the following methods:
- Add an API Category using the Admin Portal UI
- Add an API Category using the Admin REST API. (You can use the POST resource in the API Category (Individual) section here)
Add an API Category using the Admin Portal UI¶
-
Sign in to the Admin Portal.
-
Click API Category and then click API Categories.
-
Click Add New Category.
-
Enter a name and a description for the API category.
Field Value Name Food Description Fast food related APIs -
Click Save.
Step 2 - Attach the API Category to an API¶
-
Sign in to the Publisher.
-
Click on an API.
-
Click Design Configurations.
-
Select the API category.
-
Click Save.
Step 3 - List APIs in Developer Portal¶
-
Sign in to the Developer Portal.
-
Expand the Tag Cloud menu.
-
Click on the specific API category under API Categories.
All APIs that belong to the selected category appear.