Talk: How to design OpenAPIs in Workshops: The API Product Canvas
OpenAPI is a great specification language for RESTful APIs, being machine-readable and well-suited for both developers and business analysts. However, when designing APIs in collaboration with IT and business, the YAML or JSON-based standard can be overwhelming for non-technical people. To better communicate API specifications, we developed the API Product Canvas, a tool that helps communicate API specifications with ease. We will present our learnings from designing APIs with IT and non-IT people and how to get to a result in a collaborative way to make well-architectured, business-oriented APIs that are understood by developers and work in production. The audience will be equipped with a new tool: the API Product Canvas, for communicating APIs.
