OpenAPI-led Development at Nexmo

At Nexmo, we've adopted an OpenAPI-led development process to balance up-front specs with discovery, improving developer experience through human versus machine readability, automation, and a single source of truth. By creating OpenAPI specs first, we can make intentional design decisions that lead to consistent, intuitive APIs, uncover potential usability issues, and enable automation for client libraries, tests, and documentation. This process has led to higher quality API implementations, time saved, and deeper understanding, and is expected to improve the quality of APIs across the industry.