Slides used in TechConnect 2016

1. Exposing APIs with Liberty
and Swagger
Arthur De Magalhaes & Leo Christy Jesuraj
IBM Cloud
July 20, 2016
Abstract
WebSphere Liberty now provides native support for exposing REST
APIs using Swagger. This support includes auto-generating
documentation from JAX-RS and Swagger annotated apps,
propagating pre-generated documentation, and a mixture of both
scenarios in a single application. A tight integration with IBM’s API
Connect is also provided, for a complete API lifecycle management.
IBM Confidential

3. 2
Solution
IBM Confidential
Admin UI
Applications
Liberty
REST
APIProviders
API Connect
• All applications are discoverable in a single RESTful endpoint,
/ibm/api/docs
• A built-in Swagger UI is provided
at /ibm/api/explorer
Swagger
processor
swagger.yaml
• The same processing logic was pushed into an open source
server-independent Swagger processor

4. Liberty REST APIs exposed via API Connect’s Developer Portal

5. On-prem

6. Cloud

7. JAX-RS Application
with Swagger annotations

8. RepositoryREST
Controller
Admin UI
API Connect
M M
M
Hybrid collective
M
* Liberty and Docker members -> automatic publish of Swagger into repo
* StrongLoop / Node.js members -> manual publish of Swagger into repo
• Enabling apiDiscovery-1.0 on a collective member will
expose their aggregated Swagger documentation.
• Endpoints:
• /ibm/api/collective/docs
• /ibm/api/collective/explorer

9. 3Q2016: Expose REST APIs from WAS traditional