REST APIs: A Large-Scale Analysis of Compliance with Principles and Best Practices

Rodríguez, Carlos; Báez, Marcos; Daniel, Florian; Casati, Fabio; Trabucco, Juan Carlos; Canali, Luigi; Percannella, Gianraffaele

doi:10.1007/978-3-319-38791-8_2

Cited by 68 publications

(73 citation statements)

References 14 publications

(23 reference statements)

Supporting

Mentioning

Contrasting

Unclassified

Order By: Relevance

“…Moreover, in opposition of a recent assessment [2], we also showed that cloud APIs reach an acceptable level of maturity when considering good practices pertaining to understandability and reusability.…”

Section: Discussioncontrasting

confidence: 95%

“…Rodríguez et al [2] evaluated the conformance of good and bad practices in REST APIs from the perspective of mobile applications. They analysed large data logs of HTTP calls collected from the Internet traffic of mobile applications, identified usage patterns from logs, and compared these patterns with design best practices.…”

Section: Related Workmentioning

confidence: 99%

“…Several practices were proposed or identified in the literature [2,6,8,9,12] as CRUD function names should not be used in URIs or Lowercase letters should be preferred in URI paths. In particular, a valuable contribution is the one of Massé [6], who compiles several design practices about REST APIs.…”

mentioning

confidence: 99%

“…Compared to previous works, including some of ours [2,8,9], we study the conformance with best practices of REST APIs from the perspective of cloud providers.…”

mentioning

confidence: 99%

“…To build our catalog, we surveyed several studies of REST APIs elaborated by Massé [6], Rodrigues et al [2], Palma et al [8,9], Vinoski [13], Stowe [12], and Richardson and Ruby [11]. In particular, Massé [6] provides a concise catalog of practices organised by categories.…”

mentioning

confidence: 99%

See 4 more Smart Citations

Are REST APIs for Cloud Computing Well-Designed? An Exploratory Study

Petrillo

Merle

Moha

et al. 2016

Service-Oriented Computing

View full text Add to dashboard Cite

Abstract. Cloud computing is currently the most popular model to offer and access computational resources and services. Many cloud providers use the REST architectural style (Representational State Transfer) for offering such computational resources. However, these cloud providers face challenges when designing and exposing REST APIs that are easy to handle by end-users and/or developers. Yet, they benefit from best practices to help them design understandable and reusable REST APIs. However, these best practices are scattered in the literature and they have not be studied systematically on real-world APIs. Consequently, we propose two contributions. In our first contribution, we survey the literature and compile a catalog of 73 best practices in the design of REST APIs making APIs more understandable and reusable. In our second contribution, we perform a study of three different and well-known REST APIs from three cloud providers to investigate how their APIs are offered and accessed. These cloud providers are Google Cloud Platform, OpenStack, and Open Cloud Computing Interface (OCCI). In particular, we evaluate 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. Our results show that Google Cloud follows 66% (48/73), OpenStack follows 62% (45/73), and OCCI 1.2 follows 56% (41/73) of the best practices. Second, although these numbers are not necessarily high, partly because of the strict and precise specification of best practices, we showed that cloud APIs reach an acceptable level of maturity.

show abstract

Section: Discussioncontrasting

confidence: 95%

Section: Related Workmentioning

confidence: 99%

mentioning

confidence: 99%

“…Compared to previous works, including some of ours [2,8,9], we study the conformance with best practices of REST APIs from the perspective of cloud providers.…”

mentioning

confidence: 99%

mentioning

confidence: 99%

See 3 more Smart Citations

Are REST APIs for Cloud Computing Well-Designed? An Exploratory Study

Petrillo

Merle

Moha

et al. 2016

Service-Oriented Computing

View full text Add to dashboard Cite

show abstract

Comparison Matrices of Semantic RESTful APIs Technologies

Cheron¹,

Bourcier

Barais

et al. 2019

Lecture Notes in Computer Science

View full text Add to dashboard Cite

Semantic RESTful APIs combine the power of the REST architectural style, the Semantic Web and Linked Data. They picture a world in which Web APIs are easier to browse and more meaningful for humans while also being machine-interpretable, turning them into platforms that developers and companies can build on. We counted 36 technologies that target building such APIs. As there is no one-size-fits-all technology, they have to be combined. This makes selecting the appropriate set of technologies to a specific context a difficult task for architects and developers. So, how the selection of such a set of technologies can be eased? In this paper we propose three comparison matrices of Semantic RESTful APIs enabling technologies. It is based on the analysis of the differences and commonalities between existing technologies. It intends to help developers and architects in making an informed decision on the technologies to use. It also highlights the limitations of state-of-the-art technologies from which open challenges are derived.

show abstract

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

Kotstein¹,

Bogner²

2021

Service-Oriented Computing

View full text Add to dashboard Cite

REST APIs: A Large-Scale Analysis of Compliance with Principles and Best Practices

Cited by 68 publications

References 14 publications

Are REST APIs for Cloud Computing Well-Designed? An Exploratory Study

Are REST APIs for Cloud Computing Well-Designed? An Exploratory Study

Comparison Matrices of Semantic RESTful APIs Technologies

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

Contact Info

Product

Resources

About