Nashville, TN
September 24 - 26, 2018
Click Here For Information & Registration
Wednesday, September 26 • 11:10am - 11:30am
What API Descriptions Are Missing - Adam DuVander, EveryDeveloper

Sign up or log in to save this to your schedule, view media, leave feedback and see who's attending!

Feedback form is now closed.
The Open API Spec and other API description formats have made a big impact on API designers and consumers. While they've improved how machines talk to each other, they have missed some important human opportunities in APIs. Machines need to think in endpoints, while the human who sees the results of an API call thinks in use cases.

Running over 1,000 APIs in production for millions of users makes the human side of API clear. They want to pull new contracts from their CRM or add new orders to a shopping cart. In some APIs it may take multiple endpoints to fulfill a use case. And there are almost always endpoints that meet a machine need and don't support users directly.

In this entertaining talk, API veteran Adam DuVander will share how far we've come with API descriptions, examples of how they're missing human needs, and some ideas to bring use cases into our API description workflows.

avatar for Adam DuVander

Adam DuVander

Principal Developer Strategist, EveryDeveloper
Adam DuVander is a developer communicator and cheerleader. He helps companies reach and engage with developers through authentic content. Previously he worked for some of the best API and developer companies, including Zapier and SendGrid. Many still find his writing at ProgrammableWeb... Read More →

Wednesday September 26, 2018 11:10am - 11:30am CDT
Davidson Ballroom B 1/2