21
How to build an API your developers will love? Michael Kuehne

How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

Embed Size (px)

Citation preview

Page 1: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

How to build an API your developers will love?

Michael Kuehne

Page 2: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

Michael Kuehne Independent Software Engineer

API Specialist

Page 3: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

Why should you build an API your

developers will love?

Page 4: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

Your API is a Product

Page 5: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

Create a Developer Experience

User Scenarios & User Stories

Personas

Page 6: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

Don‘t forget these Guys

Page 7: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

UX UX Honeycomb

Page 8: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

Useful to me vs. Userful by Design

Page 9: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

End users create value

Page 10: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

Long-Term Mindset

Consistency

Page 11: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

RESTful

Naming

Page 12: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

V1 Versioning

Page 13: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

Publish your Tests

Provide Stubs

Error Messages

Page 14: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

SDKs

Dev Dashboard

Sandbox

Page 15: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne
Page 16: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

Documentation

Communication

Page 17: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

HATEOAS

Extend Responses

Page 18: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

Reliable APIs

Legal Part

Page 19: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

„An API is a Journey

Not a destination“

John Musser

Page 20: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

Thank you and start creating API your Developers will love!

Michael Kuehne [email protected]

@michikuehne

Page 21: How to build an API your developers will love (Short Version) - MuCON 2015, London by Michael Kuehne

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