from Andy Boothe
The excellent vector database Pinecone has a very useful API, but client support is sparse. While the API and its clients are in theory based off of an OpenAPI spec, no one seems to be able to find it.
But I needed an OpenAPI spec for the API, so I reverse engineered one (read: copy and pasted from the documentation).
It is very new and so should be considered very experimental. If you use it and find a bug, please open an issue, or even better submit a pull request!
The OpenAPI Generator is a wonderful bit of tech. It allow users to create an OpenAPI spec, and then generate client and server code from it in a variety of languages and platforms. I use it to generate DTOs for all my APIs, and to generate service interfaces to keep my client and server in sync. It also simplifies contract testing, if that’s your bag.
The generator is quite powerful out of the box, but it doesn’t do everything. Fortunately, it’s also extremely customizable, so if and when you find something that’s not supported out of the box, then you can make it work with minimal muss and fuss using template customization. Here’s how.
Continue reading “OpenAPI Generator Template Customization Example”