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

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

Grent, Henk (TU Delft Electrical Engineering, Mathematics and Computer Science)

Aniche, Maurício (mentor)
van Deursen, A. (graduation committee)
Poulsen, C.B. (graduation committee)
Akimov, A. (graduation committee)

Delft University of Technology

Computer Science and Engineering

2020-09-16

Web APIs can have constraints on parameters, such that not all parameters are either always required or always optional. Sometimes the presence or value of one parameter could cause another parameter to be required. Additionally, parameters could have restrictions on what kinds of values are valid. We refer to these as inter-parameter and single-parameter constraints respectively. Having a clear overview of the constraints can help API consumers to integrate without the need for additional support and with fewer integration faults.

We developed two approaches for identifying parameter constraints in complex web APIs. One approach uses online documentation to infer inter-parameter constraints, the other depends on static code analysis to extract inter- and single-parameter constraints from the control flow of the API’s source code. In our case study at several APIs at Adyen, the documentation- and code-based approach can identify 21% and 53% percent of the constraints respectively. When the constraints identified by both approaches are combined, 66% of the inter-parameter constraints can be identified. Code analysis is able to identify 78% of the single-parameter constraints.

Software Engineering
Web API
Parameter Constraints
Parameter Dependencies
API Specifications

http://resolver.tudelft.nl/uuid:672634ec-53ee-4ebd-a1f0-c958c646a261

Student theses

master thesis

© 2020 Henk Grent