Skip to Main content Skip to Navigation
Conference papers

Methods towards API Usability: A Structural Analysis of Usability Problem Categories

Abstract : The usability of Application Programming Interfaces (APIs) is one of the main factors defining the success of a software based framework. Research in the area of human computer interaction (HCI) currently mainly focuses on end-user usability and only little research has been done regarding the usability of APIs. In this paper, we present a methodology on how to use and combine HCI methods with the goal to evaluate the usability of APIs. The methodology consist of three phases - a heuristic evaluation, a developer workshop and interviews. We setup a case-study according to the methodology, in which we are evaluating the usability of a service-oriented framework API. The goal was to explore different HCI methods and compare the applicability of such methods to find usability problems in an API. The case-study combined qualitative and quantitative methods in order to investigate the usability and intuitiveness of the API itself. It allowed us to identify relevant problem areas for usability related issues that could be mapped to specific types of HCI methods. Examples for this are e.g. structural problems, which are identified mainly in inspection methods, while problems regarding errors and exception handling are mainly identified during the hands-on example part of the developer workshops conducted. The resulting problem areas allow us to develop a first classification of API related usability problems that are making the relevancy of usability issues for APIs more explicit and applicable.
Document type :
Conference papers
Complete list of metadata

Cited literature [23 references]  Display  Hide  Download
Contributor : Hal Ifip Connect in order to contact the contributor
Submitted on : Wednesday, July 5, 2017 - 3:39:14 PM
Last modification on : Wednesday, July 5, 2017 - 3:42:46 PM
Long-term archiving on: : Wednesday, January 24, 2018 - 11:45:59 PM


Files produced by the author(s)


Distributed under a Creative Commons Attribution 4.0 International License



Thomas Grill, Ondrej Polacek, Manfred Tscheligi. Methods towards API Usability: A Structural Analysis of Usability Problem Categories. 4th International Conference on Human-Centered Software Engineering (HCSE), Oct 2012, Toulouse, France. pp.164-180, ⟨10.1007/978-3-642-34347-6_10⟩. ⟨hal-01556816⟩



Record views


Files downloads