/plushcap/analysis/plaid/adopting-the-openapi-schema-to-generate-plaids-sdks

Adopting the OpenAPI schema to generate Plaid’s SDKs

What's this blog post about?

Stephen Jayakar, an engineer on Plaid's Developer Experience team, shares how the company adopted OpenAPI schema to generate its SDKs. The team faced challenges in maintaining three sources of truth for their API and decided to use an OpenAPI schema as a point of reference to generate documentation, client libraries, and part of their API. They learned valuable lessons along the way, including dealing with issues related to the Plaid API implementation, code generators, and templates. The team also had to modify their authentication process to match an OpenAPI authentication schema and made additive changes to ensure compatibility with existing libraries.

Company
Plaid

Date published
Sept. 15, 2021

Author(s)
Stephen Jayakar

Word count
1980

Language
English

Hacker News points
35


By Matt Makai. 2021-2024.