![[17.0.0.1 and later]](../ng_v17001plus.gif)
Listing all public RESTful APIs in a collective
The list contains a summary of each service, such as its name, version, and description, and a list of hosts that currently deploy this service. This list is updated in real time, changing as services are added into or removed from collective members. This list contains services from any collective member, regardless of whether the members are Liberty, Docker and Liberty, LoopBack®, or Docker and LoopBack servers.
The default URL for the collective services query is http://controller_host:controller_http_port/api/collective/registry.
Before you begin
The /api/collective/registry API is in the Liberty API Discovery feature. To query for public services in a collective, you must first add the apiDiscovery-1.0 feature to a collective controller server.xml file and then expose the Swagger 2.0 documentation in Liberty REST endpoints. Complete steps 1 and 2 of the procedure in Discovering REST API documentation on a Liberty server.
Procedure
Results
The query provides a list of public services:
{
"services":[
{
"service":"/airlines/booking",
"title":"Booking REST APIs",
"description":"A microservice exposing booking APIs for various airlines.",
"version":"1.0.0",
"hosts":[
"vm001:9081",
"vm002:9082"
]
},
{
"service":"/flight/status",
"title":"Flight Status REST APIs",
"description":"A microservice exposing flight status APIs for various airports.",
"version":"1.0.1",
"hosts":[
"vm003:9085"
]
},
{
"service":"/tourism",
"title":"Tourism REST APIs",
"description":"A microservice exposing tourism information for various popular destinations.",
"version":"2.0.0",
"hosts":[
"vm004:9443"
]
}
]
}