Building API for an existing application or applying “API first” development, I have found myself designing API from a misleading perspective. Focused on solving the problem, soon the concerns of the caller were quickly forgotten. Misunderstanding the purpose of an API ended up giving our consumers a bad time.
An API should be designed from the perspective of the caller. A Hypermedia design can empower the product “value” delivered within the API and approximate the value a user, who interacts with a UI, gets. During this presentation I would like to touch on the subject of common pitfalls that lead us to design an API from the wrong perspective, to reference types of our potential clients and provide examples on how hypermedia could help us honor our business.