apidays LIVE LONDON - The Road to Embedded Finance, Banking and Insurance with APIs Discovering API Version differences with ease Jaap Brasser, Developer Advocate at Rubrik

1. Discovering API Version differences with ease
October 27 & 28, 2020#APIDays

2. Tweets
Codes
Works
Does
Likes
jaap_brasser
jaapbrasser
Developer Advocate
Blogger, Speaker, Coder
Cloud Automation & Security

3. Agenda
The API
Challenges
Tooling
Q&A

4. Use cases
• Backup
• Cloud Data Management
• Disaster Recovery
• Anomaly detection
• Test / Dev scenarios

5. Rubrik API Architecture
Authentication:
• Basic (user/pw)
• API token
Rubrik UI
same logic applies
API Abstraction:
• SDK
• Plug-in
• Automation tool
Consumes 3rd party APIs:
• Amazon S3 API
• Blob Service REST API
Spray - framework for building REST/HTTP-
based integration layers
Spray-can - lightweight HTTP server that
handles REST methods
Spragger - generates code using OpenAPI spec
REST API
*OpenAPI spec
Versioned:
/internal
/v1
/v2

6. Who are we dealing with
Different roles, different expectations

7. Downstream Dependencies
Browser & Desktop Tools
Chrome Developer Tools
Automation Tools
Playground
Direct
SDK
Abstraction
Plug-in
https://build.rubrik.com

8. The Challenge
Jukan Tateisi Unsplash

10. Challenges • Reading changelogs
• Different product versions
• Downstream languages
• New functionality

11. The Goal
Marko

12. Ideal Scenario
• Generate report on version diffs
• Report breaking changes
• Moved endpoints
• Changes in status / body / param
• Report on SDK changes

13. What we’ve built
Eternally work in progress
Comparison
Framework
Swagger
Definitions
Downstream
SDK Analysis
Reports

14. Lessons Learned
Changelogs
are not fun
01
Automation
is fun
02
Edge cases
03
New
functionality
04
Integrate in
processes
05

15. Questions?
Jaap Brasser @jaap_brasser