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.

Scenario Driven Approach to API Generation for B/S Web Application

An Adaptive Framework for Test Data Generation from Business Specification

Web-based Application Services Composition for E-Business

Refactoring Java Code for Automatic API Generation

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

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

Generating API-usage Example for Project Developers

Keywords-driven Web APIs Group Recommendation for Automatic App Service Creation Process

Ontology-Based Test Case Generation for Testing Web Services

Generating Scenarios from Web Service Choreography

Beyond Browsing: API-Based Web Agents

Generating API Test Data Using Deep Reinforcement Learning

AN APPROACH FOR AUTOMATED COMPOSITION AND IMPLEMENTATION OF WEB APPLICATION COMPONENTS BASED ON SEMANTIC DESCRIPTION

A Model-Based Framework for Cloud API Testing

Enabling Communication via APIs for Mainframe Applications

An Exploratory Study of API Usage Examples on the Web

Automated Testing and Response Analysis ofWeb Services

Towards A Model Driven Approach To Automatic Bpel Generation

Scenario-based business modeling

Study of Test Case Generation for Web Applications

Generating Test Cases for Composite Web Services by Parsing XML Documents and Solving Constraints.