Successfully reported this slideshow.
We use your LinkedIn profile and activity data to personalize ads and to show you more relevant ads. You can change your ad preferences anytime.

Api First Design

52 views

Published on

The API development nowadays is a commodity. As developers, our challenge now is how to deliver a great experience to other developers that want to integrate with our services.

Published in: Software
  • Be the first to comment

  • Be the first to like this

Api First Design

  1. 1. API First Design Insights from the real-life usage
  2. 2. Who we are ● Klaus Peter Laube (@kplaube) ● Technologist in Systems Analysis (UNERJ) ● Blogger ○ profissionaisti.com.br ○ klauslaube.com.br ● Software Engineer at Loadsmart for almost 2 years
  3. 3. Who we are
  4. 4. API First "(...) is about a series of best practices across companies and industries that prioritize a better developer experience (DX). - ProgrammableWeb
  5. 5. API First "(...) is about a series of best practices across companies and industries that prioritize a better developer experience (DX). - ProgrammableWeb It's also about business!
  6. 6. In practice Plan & Project 01
  7. 7. In practice Plan & Project Validate 01 02
  8. 8. In practice Plan & Project Validate Test Write the code 01 02 03 04
  9. 9. In practice Plan & Project Validate Test Operate & Engage Write the code 05 01 02 03 04
  10. 10. Lessons learned - API First is not about picking technology
  11. 11. Lessons learned - API First is not about picking technology - API contracts should be the single source of truth
  12. 12. Lessons learned - API First is not about picking technology - API contracts should be the single source of truth - Consider using older Spec versions
  13. 13. Lessons learned - API First is not about picking technology - API contracts should be the single source of truth - Consider using older Spec versions - Write code that writes code
  14. 14. References ● Cornell CSI - Software design ● Ivan Vaskevych - API First approach with Swagger ● John D. Cook - Top down, bottom-up ● ProgrammableWeb - How To Design Great APIs With API-First Design ● SlideShare - Definition Driven API Development: How OAS & Swagger Help Teams Streamline Their API Development ● SlideShare - Exploring and Integrating UX in Open Source Software Development ● Wikipedia - Top-down and bottom up design ● Youtube - Bottom Up vs Top Down Design in Clojure - Mark Bastian
  15. 15. We are hiring! https://loadsmart.com/careers/

×