getting developers hooked on your api

Download Getting developers hooked on your api

Post on 13-Apr-2017

170 views

Category:

Software

3 download

Embed Size (px)

TRANSCRIPT

  • Getting Developers hooked on your API

    @nico_g

  • Nicolas Garnierself-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 thinks I do What I think I do What I actually do

    http://emojipedia.org/person-with-folded-hands/http://emojipedia.org/person-with-folded-hands/

  • 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

  • @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

    PerformanceMany languages

    API reference

    CommunitySimplicty

    Quickstart

    Support

    Wow effect Examples

  • @nico_g

    timed

    ifficulty

    supportdev

    Bad DX

  • Possible solution

    @nico_gDeveloper Evangelists

    SupportPublic doc

    Community

    Developers

    SEO

  • Where to start?

    @nico_g

    Dev focused web page

    API reference

    Examples

    Languages and libraries

    Easy navigation

    Getting started

    API Monitoring

    Possibility to contribute

  • First impression matters

    @nico_g

    Documentation

  • READING DOCS

    @nico_g

    LOL

  • C + V@nico_g

    PRAG-MA-TISM

  • @nico_g

    Dont forget anyone

    Code snippets

  • @nico_g

    Dont forget anyone

    Code snippets User guides

  • @nico_g

  • @nico_g

    Dont forget anyone

    Code snippets User guides Sample app

  • @nico_g

    Dont reinvent the wheel

    apiary

    readme.io

    slate

  • Dont 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}}];{{/filtersExists}}

    {{#argumentsExist}}$body = {{{body}}};{{/argumentsExist}}

  • @nico_g

    { "Count": 1, "Data": [ { {{#args}} "{{name}}":"{{value}}"{{#comma}},{{/comma}} {{/args}} } ], "Total": 1}

  • @nico_g

  • @nico_g

    Paw-som

    e!

  • @nico_g

  • @nico_g

  • @nico_g

    Thanks.