SlideShare a Scribd company logo
1
AAVISTA OY
Merja Kajava
APIOPS MEETUP
PROTOTYPING WITH
OPENAPI
September 17, 2019
2
MERJA KAJAVA
Founder
Senior Consultant
3
TIGHT DEADLINE -
NEED API
WHAT TO DO?
4
START WITH PROTOTYPE
AS PART OF MINIMUM VIABLE API ARCHITECTURE
5
DEVELOPER SITE
AS
A PROTOTYPE
START WITH API REFERENCE
6
DEVELOPER SITE FIRST
GET FEEDBACK FROM CUSTOMERS
1.
API Definition
with OpenAPI
+
JSON examples
2.
API ReferenceGenerate
3.
Developer SiteLink to
8
CASE SAASHOP
OPEN MARKETPLACE FOR SELF-SERVICE SAAS
PRODUCTS
9
SAASHOP INTEGRATION SCENARIO
10
DEMO
11
LESSONS LEARNED
12
ASK FEEDBACK AS EARLY AS
POSSIBLE
FASTER TO CHANGE API DEFINITION PRIOR TO
DEVELOPMENT
13
VALIDATE API
USING SEVERALTOOLS
TOOLING SUPPORT MIGHT DIFFER
14
USE REAL LOOKING EXAMPLES
INCLUDE ALSO PATTERNS IN API DEFINITION
"issueDate": ”string"
vs.
"issueDate": "2019-06-21"
The Data Refinery Company
MERJA KAJAVA
@mkajava

More Related Content

Prototyping with OpenAPI