@INPROCEEDINGS{Petrillo16-ICSOC-CloudRestAPIs,
   AUTHOR       = {Fabio Petrillo and Philippe Merle and Naouel Moha and 
      Yann-Ga�l Gu�h�neuc},
   BOOKTITLE    = {Proceedings of the 14<sup>th</sup> International Conference on Service Oriented Computing (ICSOC)},
   TITLE        = {Are REST APIs for Cloud Computing Well-Designed? An 
      Exploratory Study},
   YEAR         = {2016},
   OPTADDRESS   = {},
   OPTCROSSREF  = {},
   EDITOR       = {Michael Sheng and Eleni Stroulia and Samir Tata},
   MONTH        = {October},
   NOTE         = {13 pages.},
   OPTNUMBER    = {},
   OPTORGANIZATION = {},
   PAGES        = {157--170},
   PUBLISHER    = {Springer},
   OPTSERIES    = {},
   OPTVOLUME    = {},
   KEYWORDS     = {Topic: <b>Code and design smells</b>, 
      Venue: <c>ICSOC</c>},
   URL          = {http://www.ptidej.net/publications/documents/ICSOC16a.doc.pdf},
   PDF          = {http://www.ptidej.net/publications/documents/ICSOC16a.ppt.pdf},
   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.}
}

{"_id":"AXmDiQ3X9QiKrgkwe","bibbaseid":"petrillo-merle-moha-guhneuc-arerestapisforcloudcomputingwelldesignedanexploratorystudy-2016","downloads":0,"creationDate":"2018-01-17T20:29:42.193Z","title":"Are REST APIs for Cloud Computing Well-Designed? An Exploratory Study","author_short":["Petrillo, F.","Merle, P.","Moha, N.","Gu�h�neuc, Y."],"year":2016,"bibtype":"inproceedings","biburl":"http://www.yann-gael.gueheneuc.net/Work/Publications/Biblio/complete-bibliography.bib","bibdata":{"bibtype":"inproceedings","type":"inproceedings","author":[{"firstnames":["Fabio"],"propositions":[],"lastnames":["Petrillo"],"suffixes":[]},{"firstnames":["Philippe"],"propositions":[],"lastnames":["Merle"],"suffixes":[]},{"firstnames":["Naouel"],"propositions":[],"lastnames":["Moha"],"suffixes":[]},{"firstnames":["Yann-Ga�l"],"propositions":[],"lastnames":["Gu�h�neuc"],"suffixes":[]}],"booktitle":"Proceedings of the 14^th International Conference on Service Oriented Computing (ICSOC)","title":"Are REST APIs for Cloud Computing Well-Designed? An Exploratory Study","year":"2016","optaddress":"","optcrossref":"","editor":[{"firstnames":["Michael"],"propositions":[],"lastnames":["Sheng"],"suffixes":[]},{"firstnames":["Eleni"],"propositions":[],"lastnames":["Stroulia"],"suffixes":[]},{"firstnames":["Samir"],"propositions":[],"lastnames":["Tata"],"suffixes":[]}],"month":"October","note":"13 pages.","optnumber":"","optorganization":"","pages":"157–170","publisher":"Springer","optseries":"","optvolume":"","keywords":"Topic: <b>Code and design smells</b>, Venue: <c>ICSOC</c>","url":"http://www.ptidej.net/publications/documents/ICSOC16a.doc.pdf","pdf":"http://www.ptidej.net/publications/documents/ICSOC16a.ppt.pdf","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.","bibtex":"@INPROCEEDINGS{Petrillo16-ICSOC-CloudRestAPIs,\r\n AUTHOR = {Fabio Petrillo and Philippe Merle and Naouel Moha and \r\n Yann-Ga�l Gu�h�neuc},\r\n BOOKTITLE = {Proceedings of the 14^th International Conference on Service Oriented Computing (ICSOC)},\r\n TITLE = {Are REST APIs for Cloud Computing Well-Designed? An \r\n Exploratory Study},\r\n YEAR = {2016},\r\n OPTADDRESS = {},\r\n OPTCROSSREF = {},\r\n EDITOR = {Michael Sheng and Eleni Stroulia and Samir Tata},\r\n MONTH = {October},\r\n NOTE = {13 pages.},\r\n OPTNUMBER = {},\r\n OPTORGANIZATION = {},\r\n PAGES = {157--170},\r\n PUBLISHER = {Springer},\r\n OPTSERIES = {},\r\n OPTVOLUME = {},\r\n KEYWORDS = {Topic: <b>Code and design smells</b>, \r\n Venue: <c>ICSOC</c>},\r\n URL = {http://www.ptidej.net/publications/documents/ICSOC16a.doc.pdf},\r\n PDF = {http://www.ptidej.net/publications/documents/ICSOC16a.ppt.pdf},\r\n ABSTRACT = {Cloud computing is currently the most popular model to \r\n offer and access computational resources and services. Many cloud \r\n providers use the REST architectural style (Representational State \r\n Transfer) for offering such computational resources. However, these \r\n cloud providers face challenges when designing and exposing REST APIs \r\n that are easy to handle by end-users and/or developers. Yet, they \r\n benefit from best practices to help them design understandable and \r\n reusable REST APIs. However, these best practices are scattered in \r\n the literature and they have not be studied systematically on \r\n real-world APIs. Consequently, we propose two contributions. In our \r\n first contribution, we survey the literature and compile a catalog of \r\n 73 best practices in the design of REST APIs making APIs more \r\n understandable and reusable. In our second contribution, we perform a \r\n study of three different and well-known REST APIs from three cloud \r\n providers to investigate how their APIs are offered and accessed. \r\n These cloud providers are Google Cloud Platform, OpenStack, and Open \r\n Cloud Computing Interface (OCCI). In particular, we evaluate the \r\n coverage of the features provided by the REST APIs of these cloud \r\n providers and their conformance with the best practices for REST APIs \r\n design. Our results show that Google Cloud follows 66\\% (48/73), \r\n OpenStack follows 62\\% (45/73), and OCCI 1.2 follows 56\\% (41/73) of \r\n the best practices. Second, although these numbers are not \r\n necessarily high, partly because of the strict and precise \r\n specification of best practices, we showed that cloud APIs reach an \r\n acceptable level of maturity.}\r\n}\r\n\r\n","author_short":["Petrillo, F.","Merle, P.","Moha, N.","Gu�h�neuc, Y."],"editor_short":["Sheng, M.","Stroulia, E.","Tata, S."],"key":"Petrillo16-ICSOC-CloudRestAPIs","id":"Petrillo16-ICSOC-CloudRestAPIs","bibbaseid":"petrillo-merle-moha-guhneuc-arerestapisforcloudcomputingwelldesignedanexploratorystudy-2016","role":"author","urls":{"Paper":"http://www.ptidej.net/publications/documents/ICSOC16a.doc.pdf"},"keyword":["Topic: <b>Code and design smells</b>","Venue: <c>ICSOC</c>"],"metadata":{"authorlinks":{"gu�h�neuc, y":"https://bibbase.org/show?bib=http%3A%2F%2Fwww.yann-gael.gueheneuc.net%2FWork%2FPublications%2FBiblio%2Fcomplete-bibliography.bib&msg=embed","guéhéneuc, y":"http://www.yann-gael.gueheneuc.net/"}}},"search_terms":["rest","apis","cloud","computing","well","designed","exploratory","study","petrillo","merle","moha","gu�h�neuc"],"keywords":["topic: <b>code and design smells</b>","venue: <c>icsoc</c>"],"authorIDs":["AfJhKcg96muyPdu7S","xkviMnkrGBneANvMr"],"dataSources":["Sed98LbBeGaXxenrM","8vn5MSGYWB4fAx9Z4","KfXmPhaoCuAwjS2aX","SCHo5ZZkXuxNNaMME"]}