docs icon indicating copy to clipboard operation
docs copied to clipboard

No static version of OpenAPI schemas

Open vfragosop opened this issue 2 years ago • 0 comments

Hello!

Before #648, the final OpenAPI schemas were available on the repository and we could use them to generate clients locally. Now, there's no easily accessible way to generate clients without cloning mixpanel/docs locally.

The only way I could find to obtain the final schema was to:

  1. I've inspected the code on developer.mixpanel.com and figured you are using readme.com.
  2. After a lot of searching and inspecting readmeio/api, I found they have a public API for their schema registry.
  3. Then I could use it with the UUIDs that I found on developer.mixpanel.com, such as 2svd701elonb7h75.

Although this works fine for customers using readmeio/api, there are other (and better) libraries such as openapi-typescript that are not published by readme.com and also rely on the final OpenAPI schema.

Is it possible to have the final API schemas published somewhere, or including links to them on developer.mixpanel.com?

vfragosop avatar Nov 16 '23 15:11 vfragosop