An empirical study on web API usability: The consumer-developer perspective

Abstract

The ease with which web APIs facilitate access to diverse resources and services has led to their widespread adoption, consequently giving rise to a new business paradigm: the “API economy”. Given this, usability has become a pivotal attribute for API adoption, and within a competitive market, it merits detailed investigation. This exploratory study presents the findings of a survey targeting both consumers and developers of web APIs. The primary objectives of this survey were (1) to ascertain how respondents perceive various usability factors and (2) to identify potential correlations between specific characteristics of participant profiles and their expressed opinions. To fulfill these objectives, descriptive statistical parameters and independence tests were employed. Results indicate that documentation is regarded as the most influential factor on usability, while the quantity of consecutive parameters of the same type is perceived as the least influential. Furthermore, the findings reveal that expert opinions do not deviate significantly from those of non-experts, and that a respondent´s experience as a software developer and with web APIs can influence their perceptions regarding certain factors.A facilidade com que as APIs web permitem acessar diversos recursos e serviços levou à sua ampla adoção, dando origem a um novo paradigma de negócios: a “economia API”. Diante disso, a usabilidade tornou-se um atributo fundamental para a adoção de APIs e, em um mercado competitivo, merece pesquisa detalhada. Este estudo exploratório apresenta os resultados de uma pesquisa direcionada a consumidores e desenvolvedores de APIs web. Os principais objetivos deste estudo foram (1) verificar como os entrevistados percebem diversos fatores de usabilidade e (2) identificar possíveis correlações entre características específicas dos perfis dos participantes e suas opiniões expressas. Para cumprir esses objetivos, foram utilizados parâmetros estatísticos descritivos e testes de independência. Os resultados indicam que a documentação é considerada o fator mais influente na usabilidade, enquanto a quantidade de parâmetros consecutivos do mesmo tipo é percebida como o menos influente. Finalmente, este trabalho revela que as opiniões de especialistas e nãoespecialistas não divergem significativamente, e que a experiência de um entrevistado como desenvolvedor de software e com APIs web pode influenciar suas percepções quanto a determinados fatores.La facilidad con la que las APIs web permiten acceder a diversos recursos y servicios ha hecho que su utilización se masifique y, en consecuencia, surja una nueva perspectiva de negocio, “la economía API”. Debido a esto, su usabilidad se vuelve una propiedad clave para su adopción y, en un mercado competitivo, resulta de interés estudiarla en detalle. En este trabajo, de carácter exploratorio, se presentan los resultados de una encuesta destinada a consumidores y desarrolladores de APIs web, la cual tuvo como objetivos principales (1) inquirir cómo los encuestados perciben distintos factores de usabilidad y (2) hallar posibles relaciones entre ciertas características del perfil de los participantes y las opiniones que dieron. Para cumplir con tales objetivos, se aplicaron algunos parámetros de la estadística descriptiva y pruebas de independencia. Los resultados muestran que la documentación es considerada como el factor con mayor influencia sobre la usabilidad y la cantidad de parámetros consecutivos del mismo tipo como el factor menos influyente. Asimismo, evidencian que la opinión de los expertos no varía demasiado de la de los demás, y que la experiencia como desarrollador de software y con APIs web del encuestado puede influir sobre la opinión que este tiene respecto a determinados factores.