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 (Good API)
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

Good API

Erik Wilde is partner at Good API, where he helps organizations getting the most out of APIs and microservices. An expert in protocol design and structured data, Erik has been involved in the development of innovative technologies since the advent of the web. Previously, he was an associate adjunct professor at UC Berkeley and worked at EMC, Siemens, and CA Technologies. Erik is active in the IETF and W3C communities. He holds a PhD from ETH Zurich.