A Design Guide for Usable Web APIs

Cloud computing trends such as Software as a Service (SaaS) enable providers to host complex applications over the Internet, making them available to external consumers through an Application Programming Interface (API). The success of a SaaS, and in some sense any distributed system, is greatly inf...

Full description

Saved in:
Bibliographic Details
Published in:Programming and computer software 2020-12, Vol.46 (8), p.584-593
Main Authors: Tello-Rodríguez, M., Ocharán-Hernández, J. O., Pérez-Arriaga, J. C., Limón, X., Sánchez-García, Á.J.
Format: Article
Language:English
Subjects:
Application programming interface
Artificial Intelligence
Best practice
Case studies
Cloud computing
Computer networks
Computer Science
Design
Documentation
Grey literature
Literature reviews
Operating Systems
Productivity
Research methodology
Software
Software Engineering
Software Engineering/Programming and Operating Systems
Software-as-a-service
Systematic review
Usability
User experience
User interface
Citations: Items that this one cites
Items that cite this one
Online Access:Get full text
Tags: Add Tag
No Tags, Be the first to tag this record!
Description
Summary:Cloud computing trends such as Software as a Service (SaaS) enable providers to host complex applications over the Internet, making them available to external consumers through an Application Programming Interface (API). The success of a SaaS, and in some sense any distributed system, is greatly influenced by its API. Highly usable APIs improve the efficiency of the development process and its quality, ensuring that programmers continue to appreciate other aspects of the API while increasing their productivity. Different studies state that the design phase within the development process of an API is the most appropriate to address usability issues. Therefore, usability should be considered as an explicit criterion in the design of an API. In this paper, we propose a design guide for web APIs with an emphasis on usability, using the best practices of usable web APIs design. Our design guide is based on an adaptation of the design science research methodology (DSRM), and it is complemented with a systematic literature review and gray literature analysis concerning methods, techniques, and tools used to develop usable APIs.
ISSN:0361-7688
1608-3261
DOI:10.1134/S0361768820080241