Contributions
Re: Is it possible to have different #Ref Based on My API's Version
Thanks for the reply the proposed solution works, I used the second option. Here is my code: content: application/json: schema: anyOf: - $ref: '#/components/schemas/ConfigStructure' - $ref: '#/components/schemas/ConfigStructureV3' What I now observe is that my "Example Value" no longer appears. If I use one or the other of my defined components my example appears, but if I use the above syntax I get (no example available). The schema is behaving as it should I see both versions of my structure. Question: Is my syntax incorrect, or do I need to specify the example separately from my reference? Thanks for your help, Marc1.6KViews0likes1CommentIs it possible to have different #Ref Based on My API's Version
Hello, I am new to swagger and using OpenAPI 3 and have come across something I can't find a reference or example to. Might be that I don't know the right key words to look for. Here is a snippit of my YAML servers: - url: http://MySite:{Port}/MyRoute/{APIVersion} variables: APIVersion: enum: - '1' - '2' - '3' default: '1' Depending on what version of the API the user selects the request body schema description is different. Here is a small example of what I mean: APIVersion 1 - {MyField:0} APIVersion 2 - {MyField:0, MyNewField:1} This structure evolves with APIVersions Question: Is there a way to load a different reference depending on what APIVersion is selected by the user, or do I need to create a different YAML file for each version? Something of this nature: content: application/json: schema: if APIVersion = 1 $ref: '#/components/schemas/ConfigStructure' else if APIVersion = 2 $ref: '#/components/schemas/ConfigStructure2' Thanks for your help and time, MarcSolved1.6KViews0likes3Comments