discord/discord-api-spec

What does `x-discord-union` mean?

Closed this issue · 2 comments

As title says. There's quite a few "x-discord-union": "oneOf" adjacent to an anyOf. If this is intended, could you all update the README with what this means?

We're working on documenting all these things, but since you asked, its an extension we're using to indicate that the model is represented as a Union, and is conceptually a Union, even though it needs to be specced as an anyOf in OpenAPI since it could be parsed as multiple things

Alright, thanks! I look forward to the documentation for the specification (heh).