Sagar Bachu
👤 PersonPodcast Appearances
You know, APIs are tough things to manage. For a company, the OpenAPI spec, this great standard, widely adopted standard to describe and document SDKs, is the best chance the company has towards documenting it, understanding point in time what is the API, and also ownership. What are the APIs? How are they grouped? Which teams are on them? What services do they get deployed to?
There's a lot of questions there that often we see teams and companies kind of struggling to answer. So speakeasy is a forcing function for them to invest in making that open API spec as great as possible. Completely descriptive, fully enriched. Speakeasy helps with those gaps. We have deterministic and AI tools to kind of fill in the gaps for them.
And so the better and better that OpenAPI spec gets, the better chance you have at serving your community. The end value is always to the end user who is actually integrating with your API. So if your open API has gaps in it, more likely they are into errors. They don't understand what they're implementing.
It gets tough to maintain because it becomes institutionalized knowledge as opposed to described on the document. So there's a lot of great reasons why you invest in that open API spec. Any artifact like that that you're going to invest a ton of time into needs tooling to manage. And that's what speakeasy is at its core.
It's tooling to manage that open API spec, give you kind of very clear change management principles around it, version it, understand exactly what versions are used for what SDKs. If you invest in that spec and use speakeasy, you'll have a good document. The moment you have a good document, you could have good or great SDKs, which make integration easy.
The way SpeakEasy works there is you point us at your document, wherever it lives, in GitHub or maybe some other file storage or somewhere else. We detect changes as it evolves, as different people contribute to it, and we send you new updated code every time that happens. The moment we send you code, there's an opportunity for you to review that and say, you know, yes or no.
Like this is new code we want to ship to our customer. We do that heavy lifting of generating that code, giving you kind of provenance of its spec. But leave you as human in the loop to decide, okay, am I going to serve my ecosystem with a new version of the spec in SDK? So that's the kind of core workflow that we're built around.
And that's really the point of collaboration between us and companies that we work with.