Name
Good APIs Are Human-Centered
Frank Kilcommins
Description

For APIs to be good, they need to be useful, useable, and findable. Longevity on top can make them successful. To ensure that API longevity and adoption, it's essential to keep focus at the intersection of design, governance, and empathy for the human actors involved. Although the demographic caring about APIs is increasing, it's still developers that are the primary users. In this talk, I'll explore Behavioral-Driven-Development (BDD) as the missing link in human-centered API delivery, and how the concept of 'living documentation' combined with API specifications can enable the agile delivery of good APIs. Humans effectively learn through examples, and leveraging BDD to support the creation of example rich API definitions which take living documentation to a whole new level. Why? API specifications do more than just document what an API looks like. A consumer can understand and interact with the remote service with minimal implementation logic. The same is true on the provider side of an API, as stakeholders can communicate more effectively on the value proposition offered by any service.

Date & Time
Monday, July 24, 2023, 11:15 AM - 12:30 PM
Location Name
Salisbury Room
Download Session PDF