Engineering the Future of Software
29–31 Oct 2018: Tutorials & Conference
31 Oct–1 Nov 2018: Training
London, UK

May contain nuts: The case for API labeling

Erik Wilde (Axway)
15:5016:40 Monday, 29 October 2018
Distributed systems
Location: King's Suite - Balmoral
Secondary topics:  Best Practice, Overview
Average rating: *....
(1.33, 3 ratings)

Who is this presentation for?

  • Architects, API users, API developers, and integration specialists

Prerequisite knowledge

  • A basic understanding of what APIs are, how they are being used, and how they underpin many of today's digital transformation approaches

What you'll learn

  • Explore a labeling system for APIs that enables a better understanding of (some of) the important aspects of an API


APIs are the only visible parts of services in API-based service landscapes. The technical aspect of APIs has been widely discussed with description languages such as Swagger and OpenAPI. The nonfunctional aspects are harder to formalize but can also benefit from a framework in which information can be represented and used.

The idea of API labels is equivalent to that of standardized labeling systems in other product spaces, such as for food or machinery, which often have a framework in place that allows users to understand a few key (and often safety-critical) aspects of the product. This framework is not intended to be a complete and exhaustive description of the product. Instead, it focuses on areas that are important and helpful to make an initial product selection.

In the API space, numerous standards and best practices have evolved to describe and document APIs, but there’s still uncertainty how to best use them to combine API description, documentation, and labeling. Erik Wilde offers an overview of the existing approaches, demonstrates how to use them, and proposes an additional layer on top of which API labeling becomes more unified, and thus more useful.

Photo of Erik Wilde

Erik Wilde


Erik Wilde works on the Catalyst team at Axway. His goal is to make clients more successful by providing them with insights and guidance on their path toward API-centric architectures in particular, and on their digital transformation journey in general. Previously, he was an adjunct professor at UC Berkeley and worked at EMC, Siemens, CA Technologies, and Good API. Erik is active in the IETF and W3C communities. He holds a PhD from ETH Zurich.