Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai
-
Upload
codemotion-dubai -
Category
Data & Analytics
-
view
315 -
download
0
Transcript of Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai
![Page 1: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/1.jpg)
Getting Developers hooked on your API
@nico_g
![Page 2: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/2.jpg)
Nicolas Garnierself-taught developer@nico_g
@nico_g
![Page 3: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/3.jpg)
@nico_g
~15,000 APIs(ProgrammableWeb)
![Page 4: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/4.jpg)
@nico_g
Different kinds of APIs
![Page 5: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/5.jpg)
@nico_g
One thing in common
![Page 6: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/6.jpg)
@nico_g
US!One thing in common
![Page 7: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/7.jpg)
@nico_g
Developer Experience
code application
![Page 8: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/8.jpg)
@nico_g
code application
Developer Experience
UX
![Page 9: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/9.jpg)
@nico_g
code application
Developer Experience
DX
![Page 10: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/10.jpg)
@nico_g
Simplicity
What are we looking for as users?
![Page 11: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/11.jpg)
Developer Experience matters
Journey to developer Adoption
@nico_g
![Page 12: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/12.jpg)
@nico_g
Is it easy to use?
![Page 13: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/13.jpg)
@nico_g
Is it easy to understand?
![Page 14: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/14.jpg)
@nico_g
Is it adapted to my audience?
![Page 15: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/15.jpg)
@nico_g
You are not alone.SOAP REST
Hypermedia
GraphQL FalcorJS
![Page 16: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/16.jpg)
@nico_g
SOAPREST
Hypermedia
GraphQL FalcorJS
![Page 17: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/17.jpg)
@nico_g
Treat APIs like
products
![Page 18: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/18.jpg)
@nico_g
What really matters is
affordance & consistency
![Page 19: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/19.jpg)
@nico_g
Affordance
/pets/$ID
![Page 20: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/20.jpg)
@nico_g
Affordance
GET /pets/$ID
![Page 21: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/21.jpg)
@nico_g
Consistency
POST /foods
![Page 22: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/22.jpg)
@nico_g
API designers != end users
API
![Page 23: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/23.jpg)
What devs expect
@nico_gBeginner Expert
How does it work?
Performance design
PerformanceMany languages
API reference
CommunitySimplicty
Quickstart
Support
Wow effect Examples
![Page 24: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/24.jpg)
@nico_g
timed
ifficulty
supportdev
Bad DX
![Page 25: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/25.jpg)
Possible solution
@nico_gDeveloper Evangelists
SupportPublic doc
Community
Developers
SEO
![Page 26: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/26.jpg)
First impression matters
@nico_g
Documentation
![Page 27: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/27.jpg)
@nico_g
Documenting your API iseasy
![Page 28: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/28.jpg)
@nico_g
Swagger.ioTop-down
1. Create a Swagger definition of your API
2. Generate Server implementation
1. You already have a REST API
2. Generate the Swagger definition
Bottom-up
![Page 29: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/29.jpg)
@nico_g
![Page 30: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/30.jpg)
@nico_g
![Page 31: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/31.jpg)
READING DOCS
@nico_g
LOL
![Page 32: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/32.jpg)
⌘C + ⌘V@nico_g
PRAG-MA-TISM
![Page 33: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/33.jpg)
@nico_g
Don’t forget anyone
Code snippets
![Page 34: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/34.jpg)
![Page 35: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/35.jpg)
@nico_g
Don’t forget anyone
Code snippets User guides
![Page 36: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/36.jpg)
@nico_g
![Page 37: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/37.jpg)
@nico_g
Don’t forget anyone
Code snippets User guides Sample app
![Page 38: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/38.jpg)
![Page 39: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/39.jpg)
@nico_g
Don’t reinvent the wheel
apiary
readme.io
slate
![Page 40: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/40.jpg)
Don’t reinvent the wheel
![Page 41: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/41.jpg)
@nico_g
![Page 42: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/42.jpg)
@nico_g
metadata
code generator
templates
![Page 43: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/43.jpg)
@nico_g
…
![Page 44: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/44.jpg)
@nico_g
![Page 45: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/45.jpg)
@nico_g
![Page 46: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/46.jpg)
@nico_g
Paw-some!
![Page 47: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/47.jpg)
@nico_g
![Page 48: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/48.jpg)
@nico_g
![Page 49: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/49.jpg)
Developer Evangelist
@nico_g
What my friends think I do What my mom thinks I do What society thinks I do
What my boss thinks I do What I think I do What I actually do
�
![Page 50: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/50.jpg)
Developer Evangelist
@nico_g
Connect with devs and help them make the most of Mailjet APIs
Share knowledge at conferences, meetups & hackathons
Design and provide sample code for developers to make their use of the API easy
work on fun projects to show that you can do more with Mailjet than sending basic emails
![Page 51: Getting Developers hooked on your API by Nicolas Garnier at Codemotion Dubai](https://reader031.fdocuments.us/reader031/viewer/2022021921/58ed04a71a28ab24758b4569/html5/thumbnails/51.jpg)
Where to start?
@nico_g
Dev focused web page
API reference
Examples
Languages and libraries
Easy navigation
Getting started
API Monitoring
Possibility to contribute