Well Crafted API Models –
Key to Streamlining
Workflows
Andrew Smith
Uli Hitzel | June 2019
This lab was
brought to
you by APIs
Design First
● What can I do?
● What do I get?
● Data Models
● Authentication
● License
4
axway.com
User Story commit
OAS spec requires but
missing design oversight
code
Before
After
API shipped!?
build and publish test
deploy artifact to test env
deployment done, let
devs know
verify deployment,
correctness, test MVAPI
deploy API to
prod
test, doc,
consume?
business/PM
dev
devops
OAS spec
mock, test,
create
deployshare approved!
API shipped and delights users!
axway.com 6
Step 1: Stoplight.io | Create an OpenAPI version 2 specification
Step 2: API Builder | Use the OAS spec to mock and create APIs
Step 3: AMPLIFY Central | Secure, Throttle, Apply Governance
[“Create”, “Control”, “Consume”]
Before
Inconsistencies
across the
specification
All downstream
activities affected
$$$
Stakeholders
feedback not
considered
Customizations
and third party
issues
Consistency and automated API Governance
using the spec as source
Stakeholders feedback within design
Downstream activities accelerated for faster
API consumption, business results
After
Let’s create
APIs!
/u1i/slides
/in/uhitzel
Developer Advocate
Contract First
● What can I do?
● What do I get?
● Data Models
● Authentication
● License
BuildManageUse
● Access Control
● Security
● Quotas
● Transformation
● Service Catalog
● Self Service
● Analytics
➔ API Portal
➔ Swagger/OAS
➔ API Keys
➔ OAuth
➔ HTTP
➔ JSON
➔ Sandbox
Create API
using
API Builder
Axway API
Builder
Create Build Deploy Manage
Build with
Git and
Docker Hub
Run API on
OpenShift
Axway API
Central
Manage &
Consume
with API
Central

Well Crafted API Models – Key to Streamlining Workflows