mcrobbj
Occasional Contributor
Joined 6 years ago
User Profile
User Widgets
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?558Views0likes0CommentsExamples 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?1.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.2KViews0likes1Comment