Abstract:With the increasing adoption of services-oriented computing and cloud computing technologies, web APIs have become the fundamental building blocks for constructing software applications. Web APIs are developed and published on the internet. The functionality of web APIs can be used to facilitate the development of software applications. There are numerous studies on retrieving and recommending candidate web APIs based on user requirements from a large set of web APIs. However, there are very limited studies on the features of web APIs that make them more likely to be used and the issues of using web APIs in practice. Moreover, users’ expectations on the development and management of web APIs are rarely investigated. In this paper, we conduct a large-scale empirical study of 20,047 web APIs published at two popular and publicly accessible web API registries: ProgrammableWeb and APIs.guru. We first extract the questions posted in Stack Overflow (SO) that are relevant to the web APIs. We then manually analyze 1,885 randomly sampled SO questions and identify 24 web API issue types (e.g., authorization error ) that are encountered by users. Afterwards, we conduct a user survey to investigate the features of web APIs that users often consider when shortlisting a web API for testing before they adopt it, validate the identified types of web API issues, and understand users’ expectations on the development and management of web APIs. From the 191 received responses, we extract 14 important features for users to decide whether to use a web API (e.g., well-organized documentation ). We also gain a better understanding of web API issue types and summarize 11 categories of user expectations on web APIs (e.g., documentation and SDK/library ). As the result of our study, we provide guidelines for web API developers and registry managers to improve web APIs and promote the use of web APIs.

API Blender: A Uniform Interface to Social Platform APIs

APIReal: an API Recognition and Linking Approach for Online Developer Forums

Web APIs: Features, Issues, and Expectations – A Large-Scale Empirical Study of Web APIs from Two Publicly Accessible Registries Using Stack Overflow and a User Survey

Social Networking Interoperability Through Extended FOAF Vocabulary and Service

API method recommendation without worrying about the task-API knowledge gap.

A Web API Ecosystem through Feature-Based Reuse

Constructing and Evaluating Evolving Web-API Networks - A Complex Network Perspective

Programming Bots by Synthesizing Natural Language Expressions into API Invocations

Compatibility-Aware Web API Recommendation for Mashup Creation via Textual Description Mining

OBA: An Ontology-Based Framework for Creating REST APIs for Knowledge Graphs

RESTful API Analysis, Recommendation, and Client Code Retrieval

Apiuaas: A Reference Architecture For Facilitating Api Usage From A Data Analytics Perspective

Demystifying Application Programming Interfaces (APIs): Unlocking the Power of Large Language Models and Other Web-based AI Services in Social Work Research

The Case for API Communicability Evaluation: Introducing API-SI with Examples from Keras

Manifold-Learning Based API Recommendation for Mashup Creation

Diversified and Compatible Web APIs Recommendation in IoT

Checkers: Multi-modal Darwinian API Optimisation

Enhancing API Documentation through BERTopic Modeling and Summarization

On Designing Better Tools for Learning APIs

A probabilistic model for API contract specification retrieval focusing on the openAPI standard

Functional and Structural Fusion Based Web API Recommendations in Heterogeneous Networks.