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 (API Academy)
15:5016:40 Monday, 29 October 2018
Distributed systems
Location: King's Suite - Balmoral Level: Beginner
Secondary topics:  Best Practice, Overview

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

API Academy

Erik Wilde is a principal consultant at the API Academy, where he helps organizations get 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 and Siemens. Erik is active in the IETF and W3C communities. He holds a PhD from ETH Zurich.

Leave a Comment or Question

Help us make this conference the best it can be for you. Have questions you'd like this speaker to address? Suggestions for issues that deserve extra attention? Feedback that you'd like to share with the speaker and other attendees?

Join the conversation here (requires login)