Google Research

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

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

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.

Learn more about how we do research

We maintain a portfolio of research projects, providing individuals and teams the freedom to emphasize specific types of work