Which RESTful API Design Rules Are Important and How Do They Improve Software Quality? A Delphi Study with Industry Experts

@article{Kotstein2021WhichRA,
  title={Which RESTful API Design Rules Are Important and How Do They Improve Software Quality? A Delphi Study with Industry Experts},
  author={Sebastian Kotstein and Justus Bogner},
  journal={ArXiv},
  year={2021},
  volume={abs/2108.00033}
}
Several studies analyzed existing Web APIs against the constraints of REST to estimate the degree of REST compliance among state-of-the-art APIs. These studies revealed that only a small number of Web APIs are truly RESTful. Moreover, identified mismatches between theoretical REST concepts and practical implementations lead us to believe that practitioners perceive many rules and best practices aligned with these REST concepts differently in terms of their importance and impact on software… 

Figures and Tables from this paper

References

SHOWING 1-10 OF 33 REFERENCES
Are RESTful APIs Well-Designed? Detection of their Linguistic (Anti)Patterns
TLDR
The DOLAR approach (Detection Of Linguistic Antipatterns in REST), which applies syntactic and semantic analyses for the detection of linguistic (anti) patterns in RESTful APIs, shows that it can indeed detect linguistic ( anti)patterns with high accuracy and that they do occur in major RESTFUL APIs.
A Framework for the Structural Analysis of REST APIs
TLDR
This work introduces a framework for the structural analysis of REST APIs based on their description documents, as this allows for a comprehensive, well-structured analysis approach that also includes analyzing the corresponding API description languages.
Microservices in Industry: Insights into Technologies, Characteristics, and Software Quality
TLDR
It was found that companies generally rely on well-established technologies for service implementation, communication, and deployment, and most systems did not exhibit a high degree of technological diversity as commonly expected with Microservices.
Today's Top "RESTful" Services and Why They Are Not RESTful
TLDR
An in-depth analysis for the top 20 RESTful services listed on programmableweb.com provides evidence that hardly any of the services claiming to be RESTful is truly RESTful, probably due to the lack of rigidness and ease-of-use of currently available decision criteria.
An Analysis of Public REST Web Service APIs
TLDR
This paper goes through the Alexa.com top 4000 most popular sites to identify precisely 500 websites claiming to provide a REST web service API, and analyzes these 500 APIs for key technical features, degree of compliance with REST architectural principles, and for adherence to best practices.
REST APIs: A Large-Scale Analysis of Compliance with Principles and Best Practices
TLDR
Analysis of more than 78 GB of HTTP traffic collected by Italy’s biggest Mobile Internet provider over one full day provides insight into the compliance of state-of-the-art APIs with theoretical Web engineering principles and guidelines, knowledge that affects how applications should be developed to be scalable and robust.
Empirical Research Methods in Software Engineering
TLDR
This chapter provides a motivation for the use of empirical methods in software engineering research, and a brief introduction to four research methods: controlled experiments, case studies, surveys and post-mortem analyses.
RESTful web services: principles, patterns, emerging technologies
TLDR
This tutorial gives an introduction to the REST architectural style as the foundation for RESTful Web services and argues that it does have distinct advantages for loosely coupled services and massive scale, and that any SOA approach already has to be specifically RESTful on the business level to yield meaningful input for IT architecture design.
RESTful Web Services: Principles, Patterns, Emerging Technologies
  • C. Pautasso
  • Computer Science
    Web Services Foundations
  • 2014
TLDR
This tutorial gives an introduction to the REST architectural style as the foundation for RESTful Web services and argues that it does have distinct advantages for loosely coupled services and massive scale, and that any SOA approach already has to be specifically RESTful on the business level to yield meaningful input for IT architecture design.
Are REST APIs for Cloud Computing Well-Designed? An Exploratory Study
TLDR
This work evaluates the coverage of the features provided by the REST APIs of these cloud providers and their conformance with the best practices for REST APIs design and shows that cloud APIs reach an acceptable level of maturity.
...
1
2
3
4
...