You can always use extensions to add any information you want. Extensions are 
keys that start with `x-`.

 

 

From: <[email protected]> on behalf of Jeremy Darling 
<[email protected]>
Reply-To: "[email protected]" 
<[email protected]>
Date: Thursday, 16 March 2017 at 7:55
To: Swagger <[email protected]>
Subject: Any way in Swagger 2.0 to create route annotations, metadata, or 
something similar

 

Working on a project that is utilizing Swagger 2.0 and would like to know if 
there is a way to decorate the route with custom information. 

 

As an example maybe I want to place information such as the backend route and 
data map.  Something like:

 

paths:

  /api/v1.0.0/projects:

    get:

      metadata:

        source: 'https://someurl.com/api/v1/projects'

        map:

          name: 'name'

          ...more stuff here...

      responses:

        200:

          description:  List all projects

          schema:

            type: array

            items:

              $ref: '#/definitions/Project'

        500:

          description: System error

          schema:

            $ref: "#/definitions/Error"

 

Seems like there should be some place that we can put internal type markup on a 
per route basis.  If tags had name/value pairs that would work, but trial and 
error shows that doesn't work.

 

We can utilize a pre-load mutation, but the custom properties cause errors in 
the editor that cause it to go wonky after a bit.

-- 
You received this message because you are subscribed to the Google Groups 
"Swagger" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
For more options, visit https://groups.google.com/d/optout.


-- 
You received this message because you are subscribed to the Google Groups 
"Swagger" group.
To unsubscribe from this group and stop receiving emails from it, send an email 
to [email protected].
For more options, visit https://groups.google.com/d/optout.

Reply via email to