API Designers in the Field: Design Practices and Challenges for Creating Usable APIs

Lauren Murphy
Mary Beth Kery
Tosin Alliyu
Brad A. Myers
2018 IEEE Symposium on Visual Languages and Human-Centric Computing (VL/HCC'18)
Google Scholar

Abstract

Application Programming Interfaces (APIs) are a rapidly growing industry and the usability of the APIs is crucial to programmer productivity. Although prior research has shown that APIs commonly suffer from significant usability problems, little attention has been given to studying how APIs are designed and created in the first place. We interviewed 24 professionals involved with API design from 7 major companies to identify their training and design processes. Interviewees had insights into many different aspects of designing for API usability and areas of significant struggle. Even though use cases are central to the design of APIs, during the design phase it is challenging to discern which potential use cases of the API users will value most. After an API is released, designers lack tools to gather any feedback from this data in aggregate even as developers openly discuss the API online.