Scaling The API Flow

Gluecon 2016. Considering delivering more APIs. Here's a way to scale your API development team using tools and processes from Apiary

Transcript

1. SCALING THE API FLOW Emmanuel Paraskakis (@manp) Apiary
2. https://www.generosity.com/ community-fundraising/the- most-important-api-call-for-kin- lane/x/11550522
3. SO, YOU HAVE AN API 1 You did Design-first 2 You drive Documentation from API Blueprint or Swagger 3 API Consumers have adopted it, built apps on it
4. AWESOME,
 LET’S CREATE MORE!
5. 10 MORE?
6. 100 MORE?
7. 1000???
8. HIRE MORE PEOPLE CREATE MORE API DESIGNS SATISFY MORE API CONSUMERS CREATE MORE API “VERSIONS” DEPLOY TO MORE ENVIRONMENTS
9. “Does not scale”
10. GET YOUR SANITY BACK: TOOLS & PROCESSES
11. 1 PREPA RATIO N SCALE YOUR API FLOW D ESIG N & PRO TO TYPE D EVELO PM EN T D ELIVERY C O N SU M PTIO N A N A LYSIS 2 3 4 5 6
12. CONSISTENCY 1 PREPA RATIO N D ESIG N D EVELO PM EN T D ELIVERY C O N SU M PTIO N A N A LYSIS 2 3 4 5 6 Encode your Style Guide for improved DX
14. 1 PREPA RATIO N D EVELO PM EN T D ELIVERY C O N SU M PTIO N A N A LYSIS 2 3 4 5 6 API AS A PRODUCT D ESIG N & PRO TO TYPE
16. 1 PREPA RATIO N CHANGE MANAGEMENT D ESIG N & PRO TO TYPE D EVELO PM EN T D ELIVERY C O N SU M PTIO N A N A LYSIS 2 3 4 5 6 GitHub Flow
18. AUTOMATED TESTING 1 PREPA RATIO N D ESIG N & PRO TO TYPE D EVELO PM EN T D ELIVERY C O N SU M PTIO N A N A LYSIS 2 3 4 5 6 Don’t trust; verify!
19. Dredd github.com/apiaryio/dredd
20. SOURCE OF TRUTH 1 PREPA RATIO N D ESIG N & PRO TO TYPE D EVELO PM EN T D ELIVERY C O N SU M PTIO N A N A LYSIS 2 3 4 5 6 (re)use the API description
 for API Management & Docs
22. 5 THINGS TO DO TODAY • Encode your Style Guide • Rapid Consumer Feedback! • Use GitHub Flow • Automate Testing (TDD/CI) • Drive it all from API Description
24. apiary.io/how-to-build-api speakerdeck.com/zdne/api-flow
25. apiary.io emmanuel@apiary.io @manp