API collections can be used to group together public APIs with a common characteristic.
An API can appear in multiple collections
It is possible for one API to appear in multiple collections. This is unlike API Categories, where an API can only have a single API category associated with it.
APIs in a collection must be public
Only public APIs and spotlights can appear in collections. Private APIs can not be displayed on the API Hub page collections.
To create an API collection, first navigate to your Admin Panel, then select the Collections tab.
Under the Collections tab, select the + in the bottom right corner.
Editing and deleting collections
To edit a collection, click the collection name on the Collections tab (see screenshot above). Then click Edit and add or modify your details. Make sure to click Update after editing a collection.
You can change the collection's display order/weight by dragging and dropping the six dot icon to the right of each collection name (see screenshot above).
You can delete a collection by clicking the collection name bring up the Edit collection dialog and then clicking Delete.
You can define the following information:
The name of the collection. This will be displayed on the API Hub page and when the user clicks View All next to the collection on the API Hub page.
|- Slugified Name|
Primarily used for search engine optimization (SEO) purposes and generates the URL to access the collection.
The list of public APIs and spotlights (see below) that will be grouped together in the collection. You can search for an API and click on it to add it to the collection. You can drag and drop the items to change their order within collection (see screenshot below). The top item is displayed first in the collection. Click the X associated with an item to remove it from the collection.
Determines how high on the API Hub page that the collection will be displayed. The smaller the order number, the higher it is displayed. For example, an order of 1 will display at the top of the page. The relative order of collections can also be changed by dragging and dropping their order on the main Collections tab in the Admin Panel.
|- Short Description|
(Optional) Appears as a subheading for the collection title on the API Hub page and when the user clicks View All next to the collection on the API Hub page. (see the last two screenshots below)
|- Long Description|
Displayed at the bottom of the API collection details page (see the last screenshot below). This field supports markdown and the editor has convenient toolbar support. The API collection page is displayed when the user clicks View All next to the collection on the API Hub page. Adding a good detailed description to the collection can help users make better use of the collection. This can also be used for search engine optimization (SEO) to increase the ranking of the API collection in organic searches for hubs made public.
Displays when the user clicks View All next to the collection on the API Hub page (see the last screenshot below)
When grouping together specific APIs, you may want to include related resources such as blogs or tutorials. These can be helpful when exploring the API collection. Collection spotlights enable you to embed external url links within an API collection.
To add a collection spotlight, add or edit the collection and in the Share a Website as a Spotlight... text area in Items field, enter the URL in the following format:
Click the website that resolves to add the item to the collection (see screenshot below). You can drag the spotlight to the top of the Items if you want the spotlight to be shown first on the API Hub page (see the second screenshot below).
Once a spotlight has been added to a collection, it will be display as a card within the collection on the API Hub page.
If the API consumer clicks View All next to the collection (see above), they will see the collection under Collection Spotlights (see below).
Updated about 1 month ago