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.
Getting Developers
hooked on your API
@nico_g
Nicolas Garnier
self-taught developer
@nico_g
@nico_g
Developer Evangelist
@nico_g
What my friends think I do What my mom thinks I do What society thinks I do
What my boss thin...
Developer Evangelist
@nico_g
Connect with devs
and help them make
the most of Mailjet
APIs
Share knowledge
at conferences,...
@nico_g
~15,000 APIs
(ProgrammableWeb)
Developer Experience
matters
But what is it?
@nico_g
Developer Experience
matters
Journey to developer
Adoption
@nico_g
@nico_g
Developer Experience
code application
@nico_g
code application
Developer Experience
UX
@nico_g
code application
Developer Experience
DX
@nico_g
API designers != end users
API
What devs expect
@nico_gBeginner Expert
How does it
work?
Performance
design
Performance
Many languages
API reference
Comm...
@nico_g
time
difficulty
supportdev
Bad DX
Possible solution
@nico_gDeveloper Evangelists
Support
Public doc
Community
Developers
SEO
Where to start?
@nico_g
Dev focused web page
API reference
Examples
Languages and libraries
Easy navigation
Getting starte...
First impression matters
@nico_g
Documentation
READING DOCS
@nico_g
LOL
⌘C + ⌘V
@nico_g
PRAG-MA-TISM
@nico_g
Don’t forget anyone
Code snippets
@nico_g
Don’t forget anyone
Code snippets User guides
@nico_g
@nico_g
Don’t forget anyone
Code snippets User guides Sample app
@nico_g
Don’t reinvent the wheel
apiary
readme.io
slate
Don’t reinvent the wheel
while (true) {
repeat();
}
@nico_g
@nico_g
{ }
js-doc.md php-doc.md go-doc.md
</>
metadata
code generator
templates
@nico_g
{
"description" : "This call sends an email.",
"resource" : "send",
"action" : "POST",
"args" : [
…
}
@nico_g
{{#filtersExist}}
$filters = [
{{#filters}}
'{{name}}' => '{{value}}'{{#comma}},{{/comma}}
{{/filters}}
];
{{/filt...
@nico_g
{
"Count": 1,
"Data": [
{
{{#args}}
"{{name}}":"{{value}}"{{#comma}},{{/comma}}
{{/args}}
}
],
"Total": 1
}
@nico_g
@nico_g
Paw-some!
@nico_g
@nico_g
@nico_g
Thanks.
Getting developers hooked on your api
Getting developers hooked on your api
Upcoming SlideShare
Loading in …5
×

Getting developers hooked on your api

Hypermedia, REST, SOAP... It's not a matter of "why" anymore but rather of "how". Still, once your API is all set up, getting developers to use it is a real challenge. A challenge you should be ready to rise to as your API can eventually be its own channel for product adoption.

How to make sure developers know about your API, that they use it efficiently and finally, that they love using it

  • Be the first to comment

  • Be the first to like this

Getting developers hooked on your api

  1. 1. Getting Developers hooked on your API @nico_g
  2. 2. Nicolas Garnier self-taught developer @nico_g @nico_g
  3. 3. 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
  4. 4. 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
  5. 5. @nico_g ~15,000 APIs (ProgrammableWeb)
  6. 6. Developer Experience matters But what is it? @nico_g
  7. 7. Developer Experience matters Journey to developer Adoption @nico_g
  8. 8. @nico_g Developer Experience code application
  9. 9. @nico_g code application Developer Experience UX
  10. 10. @nico_g code application Developer Experience DX
  11. 11. @nico_g API designers != end users API
  12. 12. What devs expect @nico_gBeginner Expert How does it work? Performance design Performance Many languages API reference Community Simplicty Quickstart Support Wow effect Examples
  13. 13. @nico_g time difficulty supportdev Bad DX
  14. 14. Possible solution @nico_gDeveloper Evangelists Support Public doc Community Developers SEO
  15. 15. Where to start? @nico_g Dev focused web page API reference Examples Languages and libraries Easy navigation Getting started API Monitoring Possibility to contribute
  16. 16. First impression matters @nico_g Documentation
  17. 17. READING DOCS @nico_g LOL
  18. 18. ⌘C + ⌘V @nico_g PRAG-MA-TISM
  19. 19. @nico_g Don’t forget anyone Code snippets
  20. 20. @nico_g Don’t forget anyone Code snippets User guides
  21. 21. @nico_g
  22. 22. @nico_g Don’t forget anyone Code snippets User guides Sample app
  23. 23. @nico_g Don’t reinvent the wheel apiary readme.io slate
  24. 24. Don’t reinvent the wheel
  25. 25. while (true) { repeat(); } @nico_g
  26. 26. @nico_g { } js-doc.md php-doc.md go-doc.md </> metadata code generator templates
  27. 27. @nico_g { "description" : "This call sends an email.", "resource" : "send", "action" : "POST", "args" : [ … }
  28. 28. @nico_g {{#filtersExist}} $filters = [ {{#filters}} '{{name}}' => '{{value}}'{{#comma}},{{/comma}} {{/filters}} ]; {{/filtersExists}} {{#argumentsExist}} $body = {{{body}}}; {{/argumentsExist}}
  29. 29. @nico_g { "Count": 1, "Data": [ { {{#args}} "{{name}}":"{{value}}"{{#comma}},{{/comma}} {{/args}} } ], "Total": 1 }
  30. 30. @nico_g
  31. 31. @nico_g Paw-some!
  32. 32. @nico_g
  33. 33. @nico_g
  34. 34. @nico_g Thanks.

    Be the first to comment

    Login to see the comments

Hypermedia, REST, SOAP... It's not a matter of "why" anymore but rather of "how". Still, once your API is all set up, getting developers to use it is a real challenge. A challenge you should be ready to rise to as your API can eventually be its own channel for product adoption. How to make sure developers know about your API, that they use it efficiently and finally, that they love using it

Views

Total views

200

On Slideshare

0

From embeds

0

Number of embeds

4

Actions

Downloads

3

Shares

0

Comments

0

Likes

0

×