ICYDK: I’m big on supporting API providers that publish their OpenAPI definitions to GitHub. It is important for the wider API community that ALL API definitions are machine-readable and available in a way that can be forked and integrated into continuous integration pipelines. I’m not even talking about the benefits to the API providers when it comes to managing their own API lifecycle. I’m just focusing on the benefits to API consumers, and helping to make onboarding, integration, and keeping in sync with the roadmap as frictionless as possible.
To help incentivize API providers doing this, I’m committed to writing up stories for each API provider that publishes their OpenAPI, APIs.json, or Postman Collections to GitHub. Bonus points if you are doing it in an interesting way that further benefits your operations, as well as your community. Today’s API provider to showcase is the SMS, voice and phone verifications API provider Nexmo, who tweeted the GitHub repository at me, which contains their OpenAPI definition for their APIs. As they say, it is a work in progress, but it provides a damn good start for a machine-readable definition for their API(s), and I mean c’mon, aren’t all of our APIs a work in progress? https://goo.gl/9pCLMK #DataIntegration #ML
