1. Phil Wilkins
Phil.Wilkins@capgemini.com
uk.linkedin.com/in/philWilkins
@PhilAtCapgemini /
@MP3Monster
Oracle-integration.cloud /
APIPlatform.cloud /
Blog.mp3monster.org
{ developer }
Luis Weir
Luis.Weir@capgemini.com
uk.linkedin.com/in/lweir
@luisw19
Soa4u.co.uk /
APIPlatform.cloud
LONDON

2. ‹#›© 2017 Capgemini. All rights reserved.
• Technical Enterprise Architect specializing in
Integration and PaaS.
• Started out as a developer working on UI for Radar
• Moved into integration solutions –using Open Scr
Tech e.g. JBoss App Server & Fuse, Apache Camel etc.
• Worked in end user companies, ISVs & consultancy.
• Worked with Oracle tech for ~9yrs covering on-prem
and cloud.
About :: Phil Wilkins
Supported the
development of a
variety of books
Packt – Erl et al
Articles published
in a range of
Journals
Published 1st Oracle
iPaaS Book
Implementing ICS
PaaS Community
Jan, 2017
TOGAF 9 Certified
2013
• co-authored a book on Oracle Integration Cloud, contributing a new book on API Platform
• contributing to development of more than a dozen other titles ranging from Apache Camel to
Cloud Computing Design
• active blogger have had a number of articles published in various journals.

3. ‹#›© 2017 Capgemini. All rights reserved.
Publications from the Capgemini
PaaS Team
http://APIPlatform.cloud
Goes to Print Q1 2018
… Available as Alpha
(download chapters as we
finish them)
Order from …
• http://bit.ly/APIP-CS
• http://bit.ly/APIP-CS-
Amazon
https://oracle-integration.cloud
Order from …
• http://bit.ly/ImplICSBook
• http://bit.ly/ICS-Amazon
Goes to Print Q1 2018
All Packt
eBooks $5
‘til New Year

4. ‹#›© 2017 Capgemini. All rights reserved.
About me
Luis Weir
Oracle Ace Director & Developer Champion
Chief Architect at Capgemini UK
luis.weir@capgemini.com
uk.linkedin.com/in/lweir
@luisw19
http://www.soa4u.co.uk
apiplatform.cloud/
Goes to Print Q1 2018
tinyurl.com/eapim18
Goes to Print Q2 2018
tinyurl.com/apim15
Released in Set. 2015
tinyurl.com/soagov13
Released in Set. 2013
Latest articles:
• Five Minutes with Luis Weir
• 2nd vs 3rd Generation API Platforms - A Comprehensive Comparison
• Podcast: Are Microservices and APIs Becoming SOA 2.0?
• 3rd-Generation API Management: From Proxies to Micro-Gateways
• Oracle API Platform Cloud Service Overview
API
Contribution Award
PaaS Community
Split, April, 2017
Best New UK Speaker
UKOUG
Birmingham, Dec, 2016
Cloud
Contribution Award
PaaS Community
Valencia, March, 2016
Oracle Excellence
Award
Integration Category
October, 2017, SFO

5. Cloud Premier Partner
Oracle Diamond Partner
Oracle Cloud Managed Service
Provider (*New!) partner – only a
handful of SI’s
Only Global SI to be accredited as
Oracle Authorized Education Center
Part of Beta programmes for:
Cotainer Native & Microservices
Inteligent Chatbot
API platform
Integration cloud
Process cloud
Oracle Self-Service Automation
Oracle IoT Cloud
Oracle Mobile Cloud
 Continuous investments in cloud
accelerators
 5 Oracle Aces: 2 Directors, 3 Aces
 Real experts and thought leaders including
several books:
 2013: Oracle SOA Governance
Implementation
 2015: Oracle API Management
Implementation
 2016: Oracle Case Management
Solutions
 2017: Implementing Cloud service
Soon in 2018:
 Oracle API Platform CS
Implementation
 Enterprise API Management
 Several publications in OTN, Oracle
Magazine, Oracle Scene & Other
 2017 – Gold & Silver UKOUG Partner of the Year Awards
 2017 – Global Excellence Award for Extend and Connect
 2017 – API PaaS Community Award
 2017 – Chatbot PaaS Community Award
 2016 – Oracle Specialized Partner of the Year: Industry
 2016 – Oracle University Partner of the Year
 2016 – BPM and Cloud community awards
 2015 – Oracle Customer Support Services Partner of the Year
 2011 – Global Partner of the Year Award for Oracle
Applications
 2012 – Fusion Middleware partner of the year
 2010 – Partner of the year for Oracle Fusion Middleware
 2010 – 2010 EMEA Industry Partner of the Year
 2010 – Oracle Customer Services Partner of The Year
 2009 – Oracle Customer Services Partner of The Year
 2008 – Oracle Customer Services Partner of The Year
Alliance and Strategic Partnership Awards & Recognitions Thought Leadership
Article – June 17
Article – June 17
Podcast – August 17
Capgemini & Oracle

6. ‹#›© 2017 Capgemini. All rights reserved.
7:00pm
7:05pm
7:25pm
7:50pm
9:00pm
Kickoff by Phil Wilkins & Luis Weir
API Design Best Practice & API
Platform intro
Hands-on lab: design an API
that could be used to fly a
drone
So Long and thanks for all the
Pizza - End of event
This Evening ...
APIary from a Developer view
point
Please leave us feedback …
www.tinyurl.com/LondonMeetup1217

7. Source: https://uxdesign.cc/the-problem-of-identifying-
design-with-problem-solving-e5fb88d7d640
When design Goes wrong in APIs

8. Application Programming Interfaces (APIs)
are doors to information / functionality and
therefore enable digital strategies.

9. But even doors can be poorly designed…

10. 10
When does API design go wrong?
Design Build Package &
Deploy
Try
Design, build, package/deploy and
finally try happens in a sequential
way leading to feedback loops too
late in the cycle.
Waterfall’ish
API design1
Consequences:
 Long process
 APIs very difficult to change
 Compromise on design
Long Feedback-loop

11. Waterfall design or I’ll meet you half way?
Source of image: http://www.constructionhunter.com.au/blog/industry-
news/20-photos-that-will-make-you-question-your-faith-in-humanity/

12. 12
When does API design go wrong?
Design Build Package &
Deploy
Try
Design, build, package/deploy and
finally try happens in a sequential
way leading to feedback loops too
late in the cycle.
Waterfall’ish
API design1
Consequences:
 Long process
 APIs very difficult to change
 Compromise on design
Long Feedback-loop
Bottom-up
Service design2
Developers design and build APIs
based on their backend systems
knowledge without feedback from
consumers (i.e. UI developers).
Consequences:
 APIs difficult to use, UI
developers try not to use them
 API endpoints don’t align to user
journeys
Design Build Package &
Deploy
Try
Long Feedback-loop

13. 13
Bottom-up design or cashpoint for toddlers?
Source of image: http://www.constructionhunter.com.au/blog/industry-
news/20-photos-that-will-make-you-question-your-faith-in-humanity/

14. 14
When does API design go wrong?
Design Build Package &
Deploy
Try
Design, build, package/deploy and
finally try happens in a sequential
way leading to feedback loops too
late in the cycle.
Waterfall’ish
API design1
Consequences:
 Long process
 APIs very difficult to change
 Compromise on design
Long Feedback-loop
Bottom-up
Service design2
Developers design and build APIs
based on their backend systems
knowledge without feedback from
consumers (i.e. UI developers).
Consequences:
 APIs difficult to use, UI
developers try not to use them
 API endpoints don’t align to user
journeys
Design Build Package &
Deploy
Try
Long Feedback-loop
API design doesn’t really happen.
APIs are built on the fly throughout
the Sprints.
No design
because it’s agile3
Consequences:
 No API documentation
 Proliferation of APIs (hardly any
reuse)
 Dependent on individuals
Design Build Package &
Deploy
Try
Shot Feedback-loop

15. No design or wrong design?
Source of image: http://www.nydailynews.com/sports/olympics/media-reports-
sochiproblems-olympic-village-article-1.1602530

16. 16
API-design first to the rescue!

17. 17
API-design first
Feedback
Design Build Package
& Deploy
Try Continuous
Test
Feedback
RunAnalyse
Feedback

18. 18
Benefits of API-design first
Feedback
Design Build Package
& Deploy
Try Continuous
Test
Feedback
RunAnalyse
Feedback
Avoid rework: feedback early in the
cycle
By getting feedback very early in the
lifecycle, changes of rework late in the
cycle are slim. Saving time and cost.
1
Parallel development: Decouple App
dev from Service dev
By defining APIs with API Blueprints or
Swagger, app dev and service dev can
occur in parallel.
Agile: be ready for change
By continuously verifying service builds
against API definitions, non-compliant
updates can be detected quickly.
3
2

19. A 3rd Generation API solution built almost entirely from the ground
up to satisfy modern API management requirements.
API Platform
Cloud Service
Oracle API Platform Cloud Service
Planning
Design
Implementation
Publication
Operation
Consumption
Maintenance
Retirement
API

20. Why Oracle API Platform?
API
API-design ready with native
Apiary integration
Built from the ground-up to
satisfy modern API needs
First “native” hybrid API Platform.
Manage APIs anywhere (AWS, Azure,
OPC, on-prem)
Microservice ready. Lightweight,
easy to set-up and scale
Best licensing model based on
logical gateways –not CPUs

21. Any Compute
API Gateway
Runtime Derby
DB
Bundled Software
API Consumers
API Consumers
API Consumers
OnPrem
Service Endpoint
Service Endpoint
Service Endpoint
API calls Service calls
Compute NodeCompute Node
REST APIs
Management Services
Management
Portal
Developer
Portal
Public Cloud
- API Platform
Cloud Service
Management
Portal
Developer
Portal
Compute Node
Database
Cloud
REST APIs
Management Services
Management
Portal
Developer
Portal
https / phone-home
Load Balancer
OracleIdentity
CloudService
Corporate
Directory
http(s)
http(s)
http(s)
http(s)
http(s)
http(s)
Oracle API Platform Architecture

22. 22
Demo Time
Feedback
Design Build Package & DeployTry Continuous Test
Feedback
01
• Create API Blueprint
and push to Github
• Create API mock
• Expose Mock in API
Gateway
• Discover API as end user
and try
• Setup Dredd for API
definition testing
• Build microservice
using Node.JS and
MongoDB
Oracle API
Platform
02 03 04
• Create container image
and push to DockerHub
• Deploy using Docker-
compose
• Register Service to
platform
• Change Service endpoint
in Gateway
• Continuously test using
Dredd and CI tool of
choice
05
Oracle API
Platform

23. 23© 2017 Capgemini. All rights reserved.
Apiary
A developers view point …

24. 24© 2017 Capgemini. All rights reserved.
Collaborative
• Different Roles & Role
Management
• Readers
• Team Members
• Role controls depend
upon account type
• Integration with
GitHub
• Tooling to define and
check for alignment to
choosen standards &
Consistency
• Build your own
rules
API Definition Mock, Stub, Test &
Production
CapabilitiesAPIary Feature Set
• API Blueprint +
• Markdown Syntax
for Notation
(MSON)
• Open API (aka
Swagger) supported
• Provides views that
are both technical and
consumer friendly
• Templating
• Ability to define
Mocks
• Start working
against API
immediately
• Generates Stub code
in multiple languages
• Dredd Testing
Framework
• Integrates with API
Platform Developer
Portal

25. 25© 2017 Capgemini. All rights reserved.
Demo

26. 26© 2017 Capgemini. All rights reserved.
Demo
Stop the Slides –
Let’s Look at the real thing

27. The Lab – Your Mission …
Using APIary …
• Design an API that could be used to command a Drone
• Best API Blueprint provided – we’ll implement on top of a Drone SDK
• Make APIs accessible via API Platform
Then …
• Working on getting Oracle to invest in some programmable Drones, so next Meetup …
• Using Oracle cloud develop an App to use call the API & pilot the drones around a circuit
• Get too good and we’ll add API Policies to maker it trickier.
• Can you code like the Red Barron? Or land like Harrison Ford?
• We’ll be arranging a prize for the best API

28. Apiary & API Blueprint – Links to get
you started
Tips to get you going …
• https://Apiary.io
• API Blueprint Standard - https://apiblueprint.org/
• Tutorials –
• https://apiblueprint.org/documentation/tutorial.html
• https://apiblueprint.org/documentation/advanced-tutorial.html
• API Blueprint Spec – https://github.com/apiaryio/api-
blueprint/blob/master/API%20Blueprint%20Specification.md
Ask Luis, Angelo or Phil 
In terms of APIs needed – follow the guidance from Luis to design your APIs – think API First,
but to give you some ideas on the kinds of API that maybe needed..
http://developer.parrot.com/docs/reference/bebop/index.html

29. ‹#›© 2017 Capgemini. All rights reserved.
Lab
Please leave us feedback …
www.tinyurl.com/LondonMeetup1217

30. With more than 190,000 people, Capgemini is present in over 40 countries and
celebrates its 50th Anniversary year in 2017. A global leader in consulting, technology
and outsourcing services, the Group reported 2016 global revenues of EUR 12.5 billion.
Together with its clients, Capgemini creates and delivers business, technology and
digital solutions that fit their needs, enabling them to achieve innovation and
competitiveness. A deeply multicultural organization, Capgemini has developed its own
way of working, the Collaborative Business Experience™, and draws on Rightshore®, its
worldwide delivery model.
About Capgemini
Learn more about us at
www.capgemini.com
This message contains information that may be privileged or confidential and is
the property of the Capgemini Group.
Copyright © 2017 Capgemini. All rights reserved.
Rightshore® is a trademark belonging to Capgemini.
This message is intended only for the person to whom it is addressed. If you are not the intended recipient, you are not authorized to
read, print, retain, copy, disseminate, distribute, or use this message or any part thereof. If you receive this message in error, please
notify the sender immediately and delete all copies of this message.