Over a million developers have joined DZone.
{{announcement.body}}
{{announcement.title}}

SendGrid Managing Their OpenAPI Using GitHub

DZone's Guide to

SendGrid Managing Their OpenAPI Using GitHub

In this post, we find out why using OpenAPI and GitHub together can help evolve your own API quickly and efficiently.

· Integration Zone ·
Free Resource

The new Gartner Critical Capabilities report explains how APIs and microservices enable digital leaders to deliver better B2B, open banking and mobile projects.

This is a post that has been in my API notebook for quite a while. I feel it is important to keep showcasing the growing number of API providers who are not just using OpenAPI but also managing them on GitHub, so I had to make the time to talk about the email API provider SendGrid managing their OpenAPI using GitHub. Adding to the stack of top-tier API providers managing their API definitions in this way.Image title

SendGrid is managing announcements around their OpenAPI definition using GitHub, allowing developers to signup for email notifications around releases and breaking changes. You can use the GitHub repository to stay in tune with the API roadmap, and contribute feature requests, submit bug reports, and even submit a pull request with the changes you’d like to see. Going beyond just an API definition being about API documentation, and actually driving the API roadmap and feedback loop.

This approach to managing an API definition, while also making it a centerpiece of the feedback loop with your community, is why I keep beating this drum and showcasing API providers who are doing this. It is a way to manage the central API contract, where the platform provider and API consumers both have a voice and produce a machine-readable artifact that can be then used across the API lifecycle, from design to deprecation. Elevating the API definition beyond just a by-product of creating API docs, and making it a central actor in everything that occurs as part of API operations.

I’m still struggling with convincing API providers that they should be adopting OpenAPI. That it is much more than an artifact driving interactive documentation. Showcasing companies like SendGrid using OpenAPI, as well as their usage of GitHub, is an important part of me convincing other API providers to do the same. If you want me to write about your API, and what you are working to accomplish with your API resources, then publish your OpenAPI definition to GitHub, and engage with your community there. It may take me a few months, but, eventually, I will get around to writing it up, and incorporating your story into my toolbox for changing behavior in our API community.

The new Gartner Critical Capabilities for Full Lifecycle API Management report shows how CA Technologies helps digital leaders with their B2B, open banking, and mobile initiatives. Get your copy from CA Technologies.

Topics:
openapi ,github ,integration ,apis

Published at DZone with permission of

Opinions expressed by DZone contributors are their own.

{{ parent.title || parent.header.title}}

{{ parent.tldr }}

{{ parent.urlSource.name }}