Reduce API Debugging Overhead via Knowledge Prepositioning

03/23/2023
by   Shujun Wang, et al.
0

OpenAPI indicates a behavior where producers offer Application Programming Interfaces (APIs) to help end-users access their data, resources, and services. Generally, API has many parameters that need to be entered. However, it is challenging for users to understand and document these parameters correctly. This paper develops an API workbench to help users learn and debug APIs. Based on this workbench, much exploratory work has been proposed to reduce the overhead of learning and debugging APIs. We explore the knowledge, such as parameter characteristics (e.g., enumerability) and constraints (e.g., maximum/minimum value), from the massive API call logs to narrow the range of parameter values. Then, we propose a fine-grained approach to enrich the API documentation by extracting dependency knowledge between APIs. Finally, we present a learning-based prediction method to predict API execution results before the API is called, significantly reducing user debugging cycles. The experiments evaluated on the online system show that this work's approach substantially improves the user experience of debugging OpenAPIs.

READ FULL TEXT
research
03/23/2023

gDoc: Automatic Generation of Structured API Documentation

Generating and maintaining API documentation with integrity and consiste...
research
03/24/2023

Improving API Documentation Comprehensibility via Continuous Optimization and Multilingual SDK

Optimizing and maintaining up-to-date API documentation is a challenging...
research
08/17/2018

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

In addition to their vital role in professional software development, Ap...
research
06/19/2019

A survey of OpenRefine reconciliation services

We review the services implementing the OpenRefine reconciliation API, c...
research
05/08/2019

Pilot evaluation of Collection API with PID Kernel Information

Persistent Identifier (PID) is a widely used long-term unique reference ...
research
02/01/2021

Automatically Identifying Parameter Constraints in Complex Web APIs: A Case Study at Adyen

Web APIs may have constraints on parameters, such that not all parameter...
research
07/26/2016

OntoCat: Automatically categorizing knowledge in API Documentation

Most application development happens in the context of complex APIs; ref...

Please sign up or login with your details

Forgot password? Click here to reset