Planned maintenance
A system upgrade is planned for 10/12-2024, at 12:00-13:00. During this time DiVA will be unavailable.
Change search
CiteExportLink to record
Permanent link

Direct link
Cite
Citation style
  • apa
  • ieee
  • modern-language-association-8th-edition
  • vancouver
  • Other style
More styles
Language
  • de-DE
  • en-GB
  • en-US
  • fi-FI
  • nn-NO
  • nn-NB
  • sv-SE
  • Other locale
More languages
Output format
  • html
  • text
  • asciidoc
  • rtf
Assessing the linguistic quality of REST APIs for IoT applications
Linnaeus University, SWE.
Linnaeus University, SWE.ORCID iD: 0000-0003-1154-5308
Linnaeus University, SWE.ORCID iD: 0000-0002-0835-823X
Blekinge Institute of Technology, Faculty of Computing, Department of Software Engineering.ORCID iD: 0000-0003-1350-7030
2022 (English)In: Journal of Systems and Software, ISSN 0164-1212, E-ISSN 1873-1228, Vol. 191, article id 111369Article in journal (Refereed) Published
Abstract [en]

Internet of Things (IoT) is a growing technology that relies on connected ‘things’ that gather data from peer devices and send data to servers via APIs (Application Programming Interfaces). The design quality of those APIs has a direct impact on their understandability and reusability. This study focuses on the linguistic design quality of REST APIs for IoT applications and assesses their linguistic quality by performing the detection of linguistic patterns and antipatterns in REST APIs for IoT applications. Linguistic antipatterns are considered poor practices in the naming, documentation, and choice of identifiers. In contrast, linguistic patterns represent best practices to APIs design. The linguistic patterns and their corresponding antipatterns are hence contrasting pairs. We propose the SARAv2 (Semantic Analysis of REST APIs version two) approach to perform syntactic and semantic analyses of REST APIs for IoT applications. Based on the SARAv2 approach, we develop the REST-Ling tool and empirically validate the detection results of nine linguistic antipatterns. We analyse 19 REST APIs for IoT applications. Our detection results show that the linguistic antipatterns are prevalent and the REST-Ling tool can detect linguistic patterns and antipatterns in REST APIs for IoT applications with an average accuracy of over 80%. Moreover, the tool performs the detection of linguistic antipatterns on average in the order of seconds, i.e., 8.396 s. We found that APIs generally follow good linguistic practices, although the prevalence of poor practices exists.

Place, publisher, year, edition, pages
Elsevier, 2022. Vol. 191, article id 111369
Keywords [en]
REST APIs, IoT applications, Linguistic quality, Pattern, Antipattern, Detection
National Category
Software Engineering
Identifiers
URN: urn:nbn:se:bth-23126DOI: 10.1016/j.jss.2022.111369ISI: 000814741100004OAI: oai:DiVA.org:bth-23126DiVA, id: diva2:1669152
Part of project
SHADE- A value-oriented strategy for managing the degradation of software assets, Knowledge Foundation
Funder
Knowledge Foundation, 20170176
Note

open access

Available from: 2022-06-14 Created: 2022-06-14 Last updated: 2022-08-08Bibliographically approved

Open Access in DiVA

fulltext(1143 kB)123 downloads
File information
File name FULLTEXT01.pdfFile size 1143 kBChecksum SHA-512
405724d145c6b432c10c29d9476c711f7b427e8944500dd45dbaa4a4985a0f22c74a0c2d213c2aa89aeb39a6d1c9aba5ce61b0d57ce334141e014b0ec3b4e4b5
Type fulltextMimetype application/pdf

Other links

Publisher's full text

Authority records

Gonzalez-Huerta, Javier

Search in DiVA

By author/editor
Olsson, TobiasWingkvist, AnnaGonzalez-Huerta, Javier
By organisation
Department of Software Engineering
In the same journal
Journal of Systems and Software
Software Engineering

Search outside of DiVA

GoogleGoogle Scholar
Total: 123 downloads
The number of downloads is the sum of all downloads of full texts. It may include eg previous versions that are now no longer available

doi
urn-nbn

Altmetric score

doi
urn-nbn
Total: 124 hits
CiteExportLink to record
Permanent link

Direct link
Cite
Citation style
  • apa
  • ieee
  • modern-language-association-8th-edition
  • vancouver
  • Other style
More styles
Language
  • de-DE
  • en-GB
  • en-US
  • fi-FI
  • nn-NO
  • nn-NB
  • sv-SE
  • Other locale
More languages
Output format
  • html
  • text
  • asciidoc
  • rtf