This is the first part of a series of stories I’m planning to write on developing APIs. I’m hoping to help share some techniques and my approach to developing APIs along the way.

So, where to start? Documentation of course!

Developing an API should first start with documentation. That documentation should be treated as a first class artifact created by developers.

You might be wondering “um, how about writing some code” and its a fair question. How people use an API is they make a request, and that request conforms to a spec. How does that spec get communicated? Sometimes…

Thomas Karam

Get the Medium app

A button that says 'Download on the App Store', and if clicked it will lead you to the iOS App store
A button that says 'Get it on, Google Play', and if clicked it will lead you to the Google Play store