APIdays Helsinki 2019 - Balancing Between Internal and External Developer (API) Experience with Jarkko Moilanen, Platform of Trust
1 like118 views
The document discusses the critical role of developer experience in the API economy, noting that poor experiences cost the industry about $85 billion annually. It emphasizes the need for accessible tools and APIs to enhance development speed and efficiency while balancing both internal and external developer experiences. Additionally, it highlights specific tools and methodologies like RAML and OpenAPI for API documentation and the importance of maintaining up-to-date resources for developers.
![Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows @Jarkko_Moilanen
INSOMNIA“They [Insomnia] tend to address the
bugs and feature requests in GitHub
pretty fast”.
“I initially switched to it [Insomnia]
simply because the `hosts` bug made
Postman unusable”
[Insomnia] easier for both new users
and experienced users, as well as just
having more useful features, and most
critically - less bugs.](https://image.slidesharecdn.com/jarkkomoilanen-190716094337/85/APIdays-Helsinki-2019-Balancing-Between-Internal-and-External-Developer-API-Experience-with-Jarkko-Moilanen-Platform-of-Trust-16-320.jpg)
APIdays Helsinki 2019 - Balancing Between Internal and External Developer (API) Experience with Jarkko Moilanen, Platform of Trust
- 1. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows BALANCING BETWEEN INTERNAL AND EXTERNAL DEVELOPER (API) EXPERIENCE Jarkko Moilanen Developer eXperience Lead @jarkko_moilanen
- 2. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows ANNUAL LOSS 85$ BILLION Developers spend approximately four hours a week on “bad code,” which equates to nearly $85 billion worldwide in opportunity cost lost annually Bad Developer eXperience is the Joker of the API Economy, burning billions of dollars while just watching the flames. @Jarkko_Moilanen
- 3. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows LACK OF DEVELOPERS The amount of skilled developers is limiting development More easily usable tools and APIs can increase the developer base and speed in development @Jarkko_Moilanen
- 4. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows REDUCED TIME TO MARKET Getting product to markets fast is essential. Great Developer eXperience with tools and APIs can significantly reduce the time to market timespan. @Jarkko_Moilanen
- 5. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows DATA LINKING PLATFORM we make your data flow easily, with marginal of cost while you rule your data @Jarkko_Moilanen
- 6. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows DX LEAD GOAL Provide easy access to data and efficient tools to foster creation of applications. Make world more developer friendly Improve the developer experience in everything @Jarkko_Moilanen
- 7. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows API DEVELOPER EXPERIENCE Creates value (solves a problem) Reliable Low learning curve Self-service Up-to-date accurate documentation Support Unified and consistent @Jarkko_Moilanen
- 8. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows DX LEAD GOAL WITH LIMITATIONS Maximum positive developer experience for the platform (developer) consumers without killing the internal developer experience. @Jarkko_Moilanen
- 9. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows APIS PLAY CRUCIAL ROLE @Jarkko_Moilanen The Developer Coefficient report 2018, Stripe & Harris Pol, More than 1,000 developers and more than 1,000 C-level executives
- 10. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows LANDSCAPE @Jarkko_Moilanen API Docs API management Sandbox environment Data Product creation Data Consuming Developer Portal API Design Guide CLI tools and libraries Analytics
- 11. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows 3 CASES FROM PAST 6 MONTHS @Jarkko_Moilanen Architecture vs exposed APIs RAML vs OpenAPI spec Postman vs Insomnia Related to API Docs
- 12. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows @Jarkko_Moilanen ARCHITECTURE EXPOSED APIS • Microservices architecture • Lots of internal APIs • Identity API • Broker API • Product API • …. • Developer needs logical entities • Product and data from same • As few API calls as possible • No chatty APIs ”Your and my primary concern requires compromises. Let’s use HAProxy / API management to solve this”
- 13. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows @Jarkko_Moilanen RAML OPEN API • Internal choice • Reuse efficiency • Fading ecosystem • Not possible to use in Slate based documentation • ”Consumer’s choice” • Default and expected • Growing ecosystem • Tooling grows • Can be used in Slate ”Use RAML, I’ll make a tool to handle gap between Slate and RAML”
- 14. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows @Jarkko_Moilanen Github Custom tool Slate Github RAML 6 Code examples 40+ Open API spec Slate formatted markdown Build static html pages Stripe style 3 column API documentation Served via Github pages under own domain Change in Github master automatically fires regeneration and deployment of API Docs ALWAYS UP-TO-DATE API DOCUMENTATION docs.oftrust.net
- 15. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows @Jarkko_Moilanen INSOMNIA POSTMAN Both provide pretty much the same capabilities to test APs
- 16. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows @Jarkko_Moilanen INSOMNIA“They [Insomnia] tend to address the bugs and feature requests in GitHub pretty fast”. “I initially switched to it [Insomnia] simply because the `hosts` bug made Postman unusable” [Insomnia] easier for both new users and experienced users, as well as just having more useful features, and most critically - less bugs.
- 17. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows @Jarkko_Moilanen INTERNAL EFFICIENCY WINS Internal developer experience is more important in the beginning to assure development speed Find tools or build processes to satisfy 3rd party DX needs derived from internal DX.
- 18. Platformoftrust.net @PlatformOfTrust #dataliikkuu #dataflowsPlatformoftrust.net @PlatformOfTrust #dataliikkuu #dataflows @Jarkko_Moilanen BECOMING OPERATIONAL IN 2019! Psst! Sandbox is open already and free for all. developers.oftrust.net