In the Event Endpoint Management catalog, you can browse and discover information about the virtual topics available in your organization. When you log in to Event Endpoint Management, the Event Catalog is your landing page in the Event Endpoint Management UI.
You can also publish virtual topics to IBM API Connect Developer Portal, where users can discover them alongside their organization’s APIs and other services.
The Catalog
All virtual topics published to the Event Endpoint Management catalog are available in the Event Endpoint Management UI home page (Catalog) and you can use the catalog to find out more about what each virtual topic is used for by clicking the virtual topic name.
The information that is documented for each virtual topic can include the following detail:
- A description of the event data that is available from the virtual topic.
- Tags that describe the content of the topic through keywords.
- The number of replicas and partitions a topic has. This information is useful for client application developers planning how their application can consume from the virtual topic.
- Contact information for the virtual topic owner.
- Schema details if the virtual topic uses a schema. Schemas define the structure of the data in a message to ensure that the expected structure is used.
- Sample messages to show what information the topic holds.
- A Code accelerator section that provides sample Java, Node.JS, and kcat client template code.
Access to the event data from virtual topics is granted by subscribing an application to the virtual topic. The application credentials can be used to access the virtual topic through the Event Gateway. For more information, see how you can subscribe to virtual topics.
Searching the Catalog
You can search for a specific virtual topic within the catalog by entering your search text next to the Search icon 
. If your search text is matched with a word or consecutive words from the following fields, the matched content is returned in the catalog:
- Virtual topic alias
- Virtual topic name
- Description
- Tags
- Contact information
- Schema content
- Schema description
- Sample messages
Partial matches that start with the same consecutive characters as a virtual topic alias or name are also returned.
Exporting virtual topic details
To export a virtual topic as an AsyncAPI document, complete the following steps:
- In the catalog, select the virtual topic that you want to work with. A new window is displayed with more information about the virtual topic.
- Click Export AsyncAPI.
- Select the version of the AsyncAPI specification to use when exporting the document.
- Click Export.
The virtual topic details are downloaded and saved to your computer. The AsyncAPI document contains the same information about the virtual topic as presented in the catalog, and can be used in downstream tools to generate code snippets or socialize the virtual topic further.
Code accelerator samples
Expand the Code accelerator section to access sample Java, Node.JS, and kcat client template code.
Update the template code with your client credentials to verify access to your virtual topics. For more information about configuring a client application to access a virtual topic, see information about how to set up your applications to access virtual topics.
Discovering virtual topics in Developer Portal
Virtual topics that you publish to Developer Portal are displayed in the portal’s Asset gallery. The Asset gallery provides a similar experience to the Event Endpoint Management catalog, it displays the virtual topic details, schemas, sample messages, and code accelerator.
To discover virtual topics in Developer Portal:
- Log in to Developer Portal.
- Go to the Asset gallery.
- Search for the virtual topic that you want to work with.
- Click on the virtual topic to view its details, including:
- Description and documentation
- Schema information
- Sample messages
- Code accelerator samples
- Subscription options