Mythbusters : SDK Edition

An attempt at debunking the myths surrounding SDKs and SDK generation

Transcript

1. SDK Edition Lets together stop treating SDKs as step children Nauman Ali Developer and Product Manager @ APIMatic
2. ▪ SDKs are mere API wrappers (Useless) ▪ Not worth the effort – Developers prefer doing it on their own ▪ Security Risks ▪ API references with code samples are enough ▪ Adds bloated code ▪ Increases complexity APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io
3. SDKs can be the most powerful developer experience tool IF done right APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io
4. Doing SDKs right? APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io
5. APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io
6. ▪ Believe it or not ▪ Most of them are not API developers or very well accustomed to REST APIs ▪ Where is it consumed? ▪ Server Side ▪ Client Side ▪ Support all major platforms – You don’t want to annoy one particular community APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io
7. APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io
8. APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io
9. MAKE THEM A PART OF YOUR DEVELOPMENT CYCLE APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io
10. FOR THE SDKS APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io
11. APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io “…in reality, whatever people can pull down from their favorite package manager is their developer experience…” Tristan Sokol @ DevXCon 2017
12. ▪ In house development ▪ Community supported ▪ Too much resources - $$ ▪ Out of sync with APIs ▪ Increased time to market ▪ Lack of conformity ▪ Support nightmare APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io
13. APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io ▪ SDKs in sync with API definitions ▪ Support for all major platforms ▪ Generated documents and code samples ▪ Test cases ▪ Uniformity among different SDKs
14. APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io ▪ Choose a generator ▪ Customize it according to your needs ▪ Do you have a custom auth? ▪ Are there domain specific needs? ▪ Already have sdks? ▪ Generate documentation and Test cases
15. APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io
16. Update API Spec Generate / Test clients and documentation Publish Analyze and iterate APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io Identify API Choose platform Try out the API Install SDK Copy Code Samples Get started with the API PROVIDER CONSUMER
17. APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io
18. API SPECs are great They are not enough! APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io
19. APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io API Spec(s) Scenarios Test Cases SDK spec Standardized DX specs Help create tooling around it Changelogs FAQs Pricing Vendor Agnostic Publish at multiple marketplaces/catalogues
20. APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io
21. APIMatic Inc. 2018 @mnaumanali94 www.apimatic.io Twitter : @mnaumanali94 LinkedIn: naumanali