Merja Kajava presents strategies for prototyping APIs with OpenAPI at the APIops Meetup. Emphasizing the importance of building a minimum viable API quickly, the process includes creating a developer site and getting early customer feedback. Key lessons include validating API definitions with real examples and adapting them swiftly before development begins.

1. 1
AAVISTA OY
Merja Kajava
APIOPS MEETUP
PROTOTYPING WITH
OPENAPI
September 17, 2019

2. 2
MERJA KAJAVA
Founder
Senior Consultant

3. 3
TIGHT DEADLINE -
NEED API
WHAT TO DO?

4. 4
START WITH PROTOTYPE
AS PART OF MINIMUM VIABLE API ARCHITECTURE

5. 5
DEVELOPER SITE
AS
A PROTOTYPE
START WITH API REFERENCE

6. 6
DEVELOPER SITE FIRST
GET FEEDBACK FROM CUSTOMERS

7. 1.
API Definition
with OpenAPI
+
JSON examples
2.
API ReferenceGenerate
3.
Developer SiteLink to

8. 8
CASE SAASHOP
OPEN MARKETPLACE FOR SELF-SERVICE SAAS
PRODUCTS

9. 9
SAASHOP INTEGRATION SCENARIO

10. 10
DEMO

11. 11
LESSONS LEARNED

12. 12
ASK FEEDBACK AS EARLY AS
POSSIBLE
FASTER TO CHANGE API DEFINITION PRIOR TO
DEVELOPMENT

13. 13
VALIDATE API
USING SEVERALTOOLS
TOOLING SUPPORT MIGHT DIFFER

14. 14
USE REAL LOOKING EXAMPLES
INCLUDE ALSO PATTERNS IN API DEFINITION
"issueDate": ”string"
vs.
"issueDate": "2019-06-21"

15. The Data Refinery Company
MERJA KAJAVA
@mkajava