Presentation to the WebSphere User Group

1. WebSphere Connect and API Discovery
Arthur De Magalhaes
WebSphere REST API Architect
arthurdm@ca.ibm.com

2. Agenda
• API Economy and WebSphere Connect
• WebSphere API Discovery
• Demonstrations
1

3. WebSphere Connect

4. Hybrid cloud entry points for WebSphere
Create
• Create new mobile, IoT and Web
apps using APIs that connect to Java
enterprise applications
• Re-use Java application code as
Microservices
Connect
• Enhance existing apps by connecting
them with Bluemix cloud services, like
IBM Watson
• Get to market faster and extend value
of existing apps
Optimize
• Move your existing on-premises
Java applications to the cloud—
unchanged
• Reduce costs with pay-as-you-go
prices and lower CAPEX expenses
Multiple ways to get started based on business need
WebSphere Connect is an extension of the ”Connect” cloud entry point

5. WAS: Journey to Cloud 1Q16 Announcements
Breaking down the barriers to digital transformation with new hybrid cloud capabilities
Create
new cloud apps
• With Liberty app accelerator – and easily deploy to IBM Bluemix
(use Java EE7, Spring or whatever you need)
• Rapidly develop new microservices using the GameOn! Exemplar
• Best practices and guidance on refactoring Java app components into microservices to meet
requirements of cloud, mobile and social workloads
Connect
existing apps
and data
• API discovery feature to produce Swagger-documented APIs & publish them to IBM API Connect
• Utilize APIs to connect new Bluemix services and on-prem resources
• Seamlessly integrate Watson cognitive capabilities for better business decisions
• “API Connect Essentials” entitlement to meet the demands of API Economy
Optimize
Costs for Apps
• Flexibility to adopt pay-as-you-go model to optimize cost
• New WAS ND plan to deploy Enterprise Clusters/Collectives for Increased Resiliency
• Flexible T-shirt size instances for Right-Sizing your WebSphere Application Server Workload
IBM
Bluemix

6. Hybrid
Cloud
Hybrid
Cloud
Hybrid
Cloud
IBM WebSphere Connect
new on-ramps to
API Economy and Hybrid Cloud
WebSphere Connect is…
• A collection of capabilities built into WAS that help clients turn backend WAS assets into APIs and
connect to and from the hybrid cloud to rapidly extend the value of their application investments
• WebSphere Application Server v8.5.5.9 (Liberty Core, Base, ND) now includes API Connect Essentials
as a Supporting Program, adding IBM Support and 500 API calls per month per WAS PVU
To begin, let’s look in more detail at each of the capabilities summarized by the first bullet...
Business Assets
WebSphere 1Q 2016
APIs
Get all the WebSphere Connect
capabilities with the latest version
of WAS! (v8.5.5.9+)

7. IBM WebSphere Connect
new on-ramps to
API Economy and Hybrid Cloud
Expose WebSphere assets as APIs to…
• Unlock additional value from existing on-premises WAS applications by turning them into APIs for use in
new applications both inside and outside of your organization.
• Leverage existing WebSphere and Java skillset by creating APIs our of Java applications.
• Attract new clients to products and services you provide, join established API ecosystems, and create new
sources of revenue
Business Assets
APIs
(1) Turn WAS apps into APIs
• JAX-RS apps or Servlets can
be APIs
• Document with Swagger
(annotations or separate doc)
• Discover with Liberty
apiDiscovery-1.0 feature and
/ibm/api endpoints
• Support for integration with
API Connect
New
New
New

8. Hybrid
Cloud
IBM WebSphere Connect
new on-ramps to
API Economy and Hybrid Cloud
Business Assets
Enhance on-prem WAS applications by calling innovative Bluemix cloud services.
These cloud services are fully-managed without the cost, complexity, and
risk of managing your own infrastructure
Take advantage of advanced WAS capabilities when WAS seamlessly uses Bluemix
cloud services.
(2) Call Bluemix cloud services
from on-prem WAS apps
• bluemixUtility facilitates
seamless integration
• 1Q support for Watson services,
Cloudant, and API Connect
• Integrated support for more
cloud services coming…
New
New

9. IBM WebSphere Connect
new on-ramps to
API Economy and Hybrid Cloud
Consume WebSphere (and other) APIs to…
• Speed time to market and decrease costs by consuming APIs to build new and innovative applications while
maintaining high qualities of service.
• Drive innovation by merging apps, data and capabilities provided by different APIs in new ways.
• Focus on core competence and value add rather than reinventing common capabilities.
Business Assets
APIs
(3) Call WAS APIs to Connect
• REST calls
• JSON or YAML data formats

10. WebSphere Application Server
API Connect Essentials
• For Developers
• No charge / Forum Support
• 50K API calls/mo
• Micro Gateway
API Connect Professional
• For Departments with a single API
project
• Paid, with IBM support
• 5 Million API calls/mo
• Micro Gateway
API Connect Enterprise
• For Departments & Cross Enterprise
• Paid, with IBM support
• 25 Million API calls/mo
• Micro & Advanced Gateway
The API Connect Family of Offerings
API Connect Essentials “plus”
• With IBM Support
• 500 API calls/mo per WAS PVU
WebSphere Application Server
• For Liberty Core, Base, and ND
• V8.5.5.9
And includes as a Supporting Pgm...
WebSphere Connect in 1Q 2016
• Facilitates integration with API Connect
to manage and secure APIs
• Easily download API Connect Essentials
from PPA with your WAS software
• Obtain IBM Support through WAS S&S
• Increased API call limits
Now WAS includes API Connect Essentials as part of the WAS offering itself!
Use the included
API Connect Essentials to
enhance WebSphere’s
ability to Publish,
Discover, Manage, and
Secure APIs

11. Systems of Engagement
Systems of Record
Integration bus
Team
Stats
Ticketing
Systems of Insight
Audrey
Cloud App Dev
API Connect
Ron
Enterprise
Developer
WebSphere Application
Server
Catalog and
Publish APIs
Discover
APIs
WebSphere Liberty
FANAPP
Use Case: How can WebSphere Connect API capabilities speed time to market?

12. Mobile retail
customer
Spanish
Language
Systems of Insight
Purchase
History
Inventory
Management
CRM
System
Call Center
Application
Product
catalog
Live Text
Chat
application via
WebRTC
Call Center
Agent
(Spanish
speaking)
(English
speaking)
WebSphere Application
Server
Live Text
Chat
via WebRTC
Expose logic and data from
Systems of Record
Connect business
logic “to” cloud &
enhance with cloud
services
Connect “from”
cloud for health
check and
monitoring
insights
Use Case: How can WebSphere Connect capabilities enhance the retail experience?
Watson Service
for Language
Translation
Bluemix

13. API Discovery
Poll question #1

14. Swagger Introduction
• Industry leading specification for defining REST APIs.
• Supports both JSON and YAML formats.
• Large open source community with various projects on GitHub:
• Client code generation (26 languages).
• Server code generation (9 languages).
• Online editor and GUI.
• Over 2000 related open-source repository, with 15000 daily downloads.
• Base specification for Open API Initiative (https://openapis.org/), under
Linux foundation.
13

15. Swagger YAML Sample
14
paths:
/pet:
post:
tags:
- pet
summary: Add a new pet to the store
description: ''
operationId: addPet
consumes:
- application/json
- application/xml
produces:
- application/xml
- application/json
parameters:
- in: body
name: body
description: Pet object that needs to be added to the store
required: true
schema:
$ref: '#/definitions/Pet'
responses:
'405':
description: Invalid input
security:
- petstore_auth:
- 'write:pets'
- 'read:pets'

16. Swagger Annotations
• Documents the RESTful endpoint.
• Always in-sync, since it’s together with the code.
15

17. API Economy with Liberty
• There were some challenges with Swagger’s JEE support:
– No concrete guideline for exposing pre-generated docs
– No support for merging annotations with stubs
– Client generation with dependencies on Jersey and other 3rd party libs
– Support for single app only
– UI needs to be deployed separate from apps (lib bloating)
• Liberty’s apiDiscovery-1.0 feature solves it all!
16

18. API Discovery
• All applications are discoverable in a single RESTful endpoint,
/ibm/api/docs
• Query parameter allows filtering based on context root.
• Support both JSON and YAML.
• Application participation can be configured in server.xml (location, on/off).
• Available through apiDiscovery-1.0 feature.
17
Admin UI
Applications
Liberty
REST
APIProviders
API Connect

19. API Discovery User Interface
• Based on the Open Source Swagger UI
• Available at /ibm/api/explorer
18

20. API Discovery Collective Support
• Enabling apiDiscovery-1.0 on a collective member will expose their
aggregated Swagger documentation available.
• Endpoints:
– /ibm/api/collective/docs
– /ibm/api/collective/explorer
19
Admin UI
RepositoryREST
Controller
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

21. API Discovery Subscription
• POST ibm/api/docs/subscription
• Request:
{ docType: string}
• Returns:
{ feedURL : wss://ibm/api/docs/subscription/websocket/{id}, feedType: websocket }
• The client opens WSS connection and receives updates in real-time
• Equivalent collective support at /ibm/api/collective/docs/subscription
• Works with either webSocket-1.0 or webSocket-1.1
20

22. API Discovery Cloud Scenario
• Bluemix allow server packages to be pushed.
• Creates an auto-discoverable container in the cloud.
• cf push <yourappname> -p wlp/usr/servers/defaultServer
21
app
app
app
WLP
Developer

23. WebSphere Developer Tools
22

24. API Connect
Poll question #2

25. C
M
M
Pulling Liberty Assets from API Connect
24
Hybrid Collective
swagger.json

26. Pushing Standalone Assets into API Connect
Continuous Integration
product.json
Source Repository
Swagger
processor
API Connect
CLI
product.json +
swagger.json
Developer

27. Pushing Liberty Assets into API Connect
Hybrid Collective
Administrator
product.json
product.json
C
M
M
or
product.json +
swagger.json
Developer
Continuous Integration
deploy
1
2

28. API Connect Developer Toolkit
• Combines APIC’s “Drafts” experience with StrongLoop’s ARC Composer
– npm install -g apiconnect
• Offers CLI and UI flavours
27

29. Some things we’re looking at..
• Improving Java “design-first” approach
• WAS traditional support
• Core integration of API Discovery with Bluemix
• General enhancements to the UI (toggling security, style customization)
• Language support for input documents
• More integration with API Connect
• Ideas from you! Tell us!
28

30. Additional Info / Resources
• IBM Middleware User Community (WAS Forum)
https://www.imwuc.org/p/fo/si/topic=1007
• Create and vote for enhancements
https://www.ibm.com/developerworks/rfe
• dwAnswers
https://developer.ibm.com/answers/
• StackOverflow
Tags: swagger, websphere-liberty
29

31. Demonstration
• The following blog introduces 3 youTube videos and the offline
swagger processor:
http://ibm.co/1Ytyyaa
30