AI-Enhanced API Design: A New Paradigm in Usability and Efficiency
Open Access
- 11 May 2024
- conference paper
- Published by Association for Computing Machinery (ACM)
- p. 1-6
Abstract
This study uses mixed methods to evaluate API design methods, focusing on design and consumption phases. Our goal was to understand the impact of API governance approaches on productivity and usability. A controlled developer experiment (n=34) demonstrated a 10% increased requirement fulfillment using API Improvement Proposals (AIPs) and linter versus no protocols. Meanwhile, 73% of 33 surveyed API consumers preferred AIP-aligned designs for enhanced usability and comprehensibility. Complementing this, a custom large language model called the API Architect received average expert ratings of just 5/10 for specification quality, revealing gaps versus manual design. The quantitative performance metrics combined with qualitative user feedback provide evidence from multiple angles that strategically integrating industry best practices with maturing AI capabilities can meaningfully improve API design outcomes. This research offers empirical insights from developer and consumer perspectives to advance scholarly discourse and industry practice regarding optimal API design workflows.Keywords
This publication has 14 references indexed in Scilit:
- API Designers in the Field: Design Practices and Challenges for Creating Usable APIs2018
- Automated measurement of API usability: The API Concepts FrameworkInformation and Software Technology, 2015
- An Empirical Study of API Usability2013
- Some structural measures of API usabilitySoftware: Practice and Experience, 2013
- Methods towards API Usability: A Structural Analysis of Usability Problem Categories2012
- Useful, But Usable? Factors Affecting the Usability of APIs2011
- A field study of API learning obstaclesEmpirical Software Engineering, 2010
- API usability peer reviews2010
- Why are APIs difficult to learn and use?XRDS: Crossroads, The ACM Magazine for Students, 2006
- A new partitioning around medoids algorithmJournal of Statistical Computation and Simulation, 2003