How to build an API your developers will love?

Michael Kuehne

Michael Kuehne Independent Software Engineer

API Specialist

Why should you build an API your

developers will love?

Your API is a Product

Create a Developer Experience

User Scenarios & User Stories

Personas

Don‘t forget these Guys

UX UX Honeycomb

Useful to me vs. Userful by Design

End users create value

Long-Term Mindset

Consistency

RESTful

Naming

V1 Versioning

Publish your Tests

Provide Stubs

Error Messages

SDKs

Dev Dashboard

Sandbox

Documentation

Communication

HATEOAS

Extend Responses

Reliable APIs

Legal Part

„An API is a Journey

Not a destination“

John Musser

Thank you and start creating API your Developers will love!

Michael Kuehne michael@mkuehne.com

@michikuehne

Credits •  Stormtropper with Heart https://flic.kr/p/7CMCXh •  Apple Stormtropper https://flic.kr/p/8pxp41 •  Logo Quad Racer https://flic.kr/p/dXan4x •  Business man https://flic.kr/p/9ahi5b •  See in the Mountains https://flic.kr/p/bDg5Ms •  Leathermen https://flic.kr/p/7BMTj9 •  Traffic Sign https://flic.kr/p/4uZDqS •  Hello my name is https://flic.kr/p/7NudQf •  LED https://flic.kr/p/eQy2Um •  Toolbox https://flic.kr/p/bkSP2c •  Chocolate https://flic.kr/p/eMKxsK •  Boy Scouts https://flic.kr/p/cdxFkW •  Wheel chair https://flic.kr/p/9g1LDE •  Church https://flic.kr/p/opTHCA •  Kayak https://flic.kr/p/bSaLKB