Contributions
Define the format of a JWT in Open API
I can define the use of a JWT: components: securitySchemes: bearerAuth: # arbitrary name for the security scheme type: http scheme: bearer bearerFormat: JWT # optional, arbitrary value for documentation purposes I can define the schema for it in the components section but how do I bind that to the defintion above?520Views0likes0CommentsExamples in a component - Array of objects
I have a nested component that I want to have examples of So components: schema: myObject: type: object properties: authId: type: string myArray: type: array items: $ref: '#/components/schemas/myObject2' myObject2: type: object properties: filed1: type: string filed2: type: string and an example like: {authId: "123", [ { field1: "One", filed2: "two"}, { field1: "three", filed2: "four"}, ] } How do I do this?1KViews0likes2CommentsSwagger 3: Servers - prod doesnt conform to pattern
My route to live environments all follow a standard pattern, however prod doesnt conform is there anyway to change it for prod? servers: - url: https://{environment}.mywebsite.com/myendpoint variables: environment: default:api.sit# SIT server enum: -api.dev# Development server - https://{environment}.mywebsite.cloud/myendpoint -api.sit#SITserver- https://{environment}.mywebsite.cloud/myendpoint -api.uat#UATserver- https://{environment}.mywebsite.cloud/myendpoint -api.ppe#PPEserver- https://{environment}.mywebsite.cloud/myendpoint -api# Production server ( https://api.mywebsite.com/myendpoint1.1KViews0likes1Comment