1. Scaling Your API Development Workflow
Five Simple Things You Can Do Today
Pavel Michalík , CSAS
Emmanuel Paraskakis, Oracle
Adam Kliment, Oracle

3. So, You Have an API… You did Design-first You used Best Practices
You used API Blueprint or Swagger
You have API Management in place
API Consumers have adopted it, built apps on it!
You use best practices: Design-first, Docs Synced to Spec, API Management

4. Awesome… Let’s Create More! 10 More? 100 More? 1000?
Once you find success and have many APIs in-flight you will lose control
Complexity explodes with number of APIs * number of clients consuming

5. So you… Hire more Developers Create more API Designs
Integrate with more Apps
Create more API “versions”
Deploy to more Environments
Multiple APIs, Versions, Teams (internal-external, cultures, timezones)
Solution is not to hire more people, it only makes things worse

6. 🙀
Increased project risk->failed projects
“Does not scale”

7. Get Your Sanity Back: Tools & Processes1
Preparation
DesIGN & prototype
Development
Delivery
Consumption
analysis 2 3 4 5 6
Use Tools & Processes at every stage of the API Lifecycle

8. How to Scale your API Development Workflow:
Keep All your APIs Consistent
Treat your API Like the Product it is
Don’t Let Change Manage You
Automate Testing. Everywhere
API Design as Single Source of Truth

9. The Only Complete Solution for the Entire API Lifecycle
300K API Developers 400K API Projects 3M+ API Consumers

10. 1. Keep All your APIs Consistent
Preparation
DesIGN & prototype
Development
Delivery
Consumption
analysis 2 3 4 5 6
Encode your Style Guide
for improved DX
As designs proliferate, inconsistencies will creep in
Difficult to keep tabs on everything, manual process and mandates don’t work
API Standards doc that no one reads
Anecdote of multiple date formats in one response
Anecdote of wrong terminology or spelling mistake that becomes permanent

11. Demo
Demo:
Open Editor and show Style violation, Assertions, Architect Dashboard

12. 2. Treat your API Like the Product it is1
Preparation
Development
Delivery
Consumption
analysis 2 3 4 5 6
DesIGN & PROTOTYPE
API is a product not afterthought
If you build without stakeholder input you will deliver the wrong thing, lose time and risk partnerships, consumer satisfaction
So collaborate with API consumers early on

13. Demo Demo: Open editor and show mock server and inviting team members
Talk through API consumers making changes themselves
Agreement on contract

14. 3. Don’t Let Change Manage You1
Preparation
DesIGN & PROTOTYPE
Development
Delivery
Consumption
analysis 2 3 4 5 6
GitHub Flow
As you bring multiple stakeholders, can’t make edits on same document
Use GitHub flow that we are familiar with to propose changes
Owner maintains control of which changes are incorporated and when

15. Demo Demo: Open Editor create a new branch and show changes to that
Show independent docs, independent mock
Make PR
Show GH and the ability to merge PR

16. 4. Automate Testing. Everywhere1
Preparation
DesIGN & prototype
Development
Delivery
Consumption
analysis 2 3 4 5 6
Don’t trust; verify!
How do you keep implementation in sync with contract, which you already agreed with consumers?
Automated testing, on desktop (TDD), on deployment (CI/CD)
Dredd is CLI tool that takes ADD and URL and shows pass/fail
Anecdote: Talk about Knightmare

17. Demo Demo: Open VS Code and show yaml config, ADD, app.js
Run Dredd, show failure and exit code
Fix issue, deploy - switch to Dredd docs, talk how this can be part of CI/CD, pre/post
Ensure deploy was successful
Run Dredd, show passing and exit code

18. 5. API Design as Single Source of Truth1
Preparation
DesIGN & prototype
Development
Delivery
Consumption
analysis 2 3 4 5 6
(re)use the API description for API Management & Docs
You have a contract, use it to maintain sync and eliminate mistakes
We showed tests, but how do you keep consumers in sync?
Render interactive docs from contract in dev portal

19. Demo Demo: Open API Management, navigate to publish menu
Hit Apiary, allow login and pick an API from list
Publish and copy URL
Open dev portal, log in and show rendered docs
Hit resource, navigate to console and show code examples, driven by contract

20. How to Scale with Oracle API Platform
Keep All your APIs Consistent
Treat your API Like the Product it is
Don’t Let Change Manage You
Automate Testing. Everywhere
API Design as Single Source of Truth

21. Resources:
Apiary Dredd Knightmare: A Devops cautionary tale Developer Keynote KEY7383 Apiary Customer Panel CON 7017 Hands On Lab HOL7718 Design, Build, and Manage Microservices APIs with Apiary CON1561 Oracle API Platform Implementation Best Practices CON1573 API Management and Microservices, a Match Made in Heaven CON7349

22. Highly Scalable, Secure and Globally Available
Oracle Cloud Platform
Develop & Deploy
Innovate with a Comprehensive, Open, Integrated and Hybrid Cloud Platform
that is
Highly Scalable, Secure and Globally Available
Integrate & Extend
Innovate with a Comprehensive, Open, Integrated and Hybrid Cloud Platform that is Highly Scalable, Secure and Globally Available.
Enabling you to increase business agility, lower costs, and drive innovation with solutions for:
Develop and Deploy
Integrate and Extend
Publish and Engage
Analyze and Predict
Secure and Manage
Publish & Engage
Analyze & Predict
Secure & Manage

23. Built on High Performant Oracle Cloud Infrastructure
Oracle Cloud Platform
Hybrid
Comprehensive
Open
Integrated
Data Management
Analytics and Big Data
Oracle Cloud Platform:
Most Comprehensive Offering, with best of breed solutions for Data Management, AppDev, Enterprise Integration, etc.
Based on Open Standards (HTML5, REST, Kubernetes, oAuth, etc.) and giving you a choice of technology stacks
Providing Seamless Integration among PaaS offerings and across the entire Oracle Cloud Stack (IaaS, PaaS, SaaS)
True Hybrid Cloud – providing you the flexibility of deploying in Oracle’s Public Cloud or in your own data center with Oracle Customer
And leveraging the superior Scalability, Availability and Performance of Oracle’s Cloud Infrastructure
Application Development
Content & Experience
Enterprise Integration
Identity & Security
Oracle Public Cloud
Oracle Cloud at Customer
Data Integration
Systems Management
Oracle Data Center
Your Data Center
Built on High Performant Oracle Cloud Infrastructure

24. Oracle Cloud Platform Momentum
14,000+
3,000+
$1.4 Billion
10 PaaS
Oracle Cloud Platform Momentum:
Over 14k Oracle IaaS and PaaS Customers
In the Oracle Cloud Marketplace: over 3,000 apps and extensions from over 900 partners
For fiscal 2017, Oracle PaaS and IaaS revenues were up 60% to $1.4 billion (Total cloud revenues were up 60% to $4.6 billion.)
Oracle identified as a Leader in 10 major PaaS Analyst Reports (Forrester Waves/Gartner Magic Quadrants)
Oracle
Apps in the
FY17 Oracle Cloud
Categories where
Platform
Cloud Platform
Oracle Cloud
Oracle is a
Leader
Revenue
Customers
Marketplace
According to
(60% YoY Growth )
Industry
Analysts