What Why When Versioning Matters: Tips for API Design, Description, and Documentation

One of the superpowers of APIs is to design them as products with a focus on making them reusable. That helps with innovation and reuse, as teams can now consume the capabilities of other teams without having to coordinate with them, leading to faster flow. For this to work well, API versioning must be handled in a way that allows the API to evolve while at the same time not breaking existing consumers. What do you have to version? Why does it matter? When should you version? We present tips that help to improve your API design, description and documentation practices.

Date: 2024-12-05
Time: 11:15 - 12:00
Online Event: INNOQ Technology Day 2024

Speaker

Erik Wilde Principal Consultant

With over 10 years of experience in the API field, Erik is passionate about helping organizations on their digital transformation journeys, making sure that vision, strategy, and technology are aligned, and that they are driven by well-aligned business and organizational initiatives. As an OAI Ambassador at the OpenAPI Initiative, he promotes the adoption and use of open standards and best practices for API design and management, and with Getting APIs to Work, I provide consulting and training services for API programs.

What Why When Versioning Matters: Tips for API Design, Description, and Documentation

TAGS