Standard practice

Building an OpenAPI 2.0 spec for the Slack Web API

Taylor Singletary
Nov 1, 2017 · 6 min read
Image for post
Image for post
The Q149 Signal Selector by synthesizers.com
Image for post
Image for post

How to use the spec

Image for post
Image for post
To some, an API specification might seem as fun as playing with a robot that turns into a building.

Code

How we built it

Choosing OpenAPI 2.0 over alternatives

Future releases

Gotchas

Have fun, build stuff

Image for post
Image for post
Lluís Callejo in Plànols i esbossos de l’STOKOS-4. Any 1974

Slack Platform Blog

Several bots are typing…

Thanks to Slack API

Taylor Singletary

Written by

Reality Technician. Documentation & developer relations at Slack. Previously: Clever, Twitter, & LinkedIn.

Slack Platform Blog

Several bots are typing…

Taylor Singletary

Written by

Reality Technician. Documentation & developer relations at Slack. Previously: Clever, Twitter, & LinkedIn.

Slack Platform Blog

Several bots are typing…

Welcome to a place where words matter. On Medium, smart voices and original ideas take center stage - with no ads in sight. Watch

Follow all the topics you care about, and we’ll deliver the best stories for you to your homepage and inbox. Explore

Get unlimited access to the best stories on Medium — and support writers while you’re at it. Just $5/month. Upgrade

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