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

Error generating docs from Discord Open API spec #181

Closed
JustinBeckwith opened this issue Sep 6, 2024 · 5 comments · Fixed by #591
Closed

Error generating docs from Discord Open API spec #181

JustinBeckwith opened this issue Sep 6, 2024 · 5 comments · Fixed by #591
Labels
bug Something isn't working

Comments

@JustinBeckwith
Copy link

Oh, hey guys. This looks really promising! But it isn't working for me :)

Trying to give this a go at:
https://zudoku.dev/demo?api-url=https://raw.githubusercontent.com/discord/discord-api-spec/main/specs/openapi.json

Gives Unexpected error.

I thought it may be because I was pointing to the raw content, so I tried this:
https://zudoku.dev/demo?api-url=https://github.com/discord/discord-api-spec/blob/main/specs/openapi.json

Gives Failed to fetch schema

Copy link

linear bot commented Sep 6, 2024

@mosch
Copy link
Contributor

mosch commented Sep 6, 2024

Hey @JustinBeckwith – thanks for bringing this up.

We tracked down the problem to be with how deeply nested the schema is. Before we render the schema we dereference it which fails for this schema.

We're testing out a fix to implement LazyDereferencing – that only dereferences the schema where needed. This might be a good performance improvment anyway.

@mathias-goebel
Copy link

Hi. Are there any news on this? Just from reading the error msg, i suspect i have the same issue with
my openapi 3.1.0 specs at zudoku demo page.

@ntotten ntotten added the bug Something isn't working label Dec 20, 2024
@mosch
Copy link
Contributor

mosch commented Jan 23, 2025

Hey @mathias-goebel thanks for coming to this. We've been updating how we are processing the spec and expect more specs to work. I quickly tested your's and it seems to still be broken. We'll have a look at it and let you know!

@mosch
Copy link
Contributor

mosch commented Jan 28, 2025

@mathias-goebel this should be fixed by now. We'd love to learn if you have more feedback for us!

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment
Labels
bug Something isn't working
Development

Successfully merging a pull request may close this issue.

4 participants