To design APIs at scale, it takes deliberate effort to create consistency and make several discrete APIs feel like a platform. This requires an efficient and useful API design review process.

Core to all these types of failures where the API doesn’t work as planned is a need for design that considers multiple aspects of a good API plan. Let’s go back to the basics.

Design & Dev The future of API design: The orchestration layer December 17, 2013 - 8:08 pm Daniel Jacobson (Twitter | LinkedIn), is currently director of engineering for the Netflix API.

Encourage your API designers to use this approach to not only add documentation in the main body of an API design, but also in any libraries you use. There’s a lot to like in Cadl.

Kong Inc., a cloud connectivity company, is releasing a new open source tool called Insomnia Designer, offering a collaborative API design editor. Building on Insomnia Core, which Kong acquired in ...