Skip to content
New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

No static version of OpenAPI schemas #711

Open
vfragosop opened this issue Nov 16, 2023 · 0 comments
Open

No static version of OpenAPI schemas #711

vfragosop opened this issue Nov 16, 2023 · 0 comments

Comments

@vfragosop
Copy link
Contributor

vfragosop commented Nov 16, 2023

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?

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
None yet
Projects
None yet
Development

No branches or pull requests

1 participant