Esempi di API JSON in Swagger 2.0

Question

Sto cercando di creare risposte di esempio per un endpoint con Swagger 2.0.

200: 
     description: Successful response 
     schema: 
     type: object 
     $ref: "#/definitions/User" 
     examples: 
     application/vnd.api+json: 
      - data: 
       attributes: 
        full_name: John Appleseed 
      - data: 
       attributes: 
        full_name: Mike Appleseed 

mio api consuma e produce application/vnd.api+json, ma non lo riconoscerà. Se elimino gli esempi, le mie specifiche funzionano. Qualche idea su come specificarlo?

Answer 1

È not fully implemented yet, anche se è possibile definire un unico esempio come questo:

responses: 
    "200": 
     description: Successful response 
     schema: 
     $ref: '#/definitions/User' 
     examples: 
     application/json: 
      data: 
      id: 1 
      attributes: 
       attr1: value1 
       attr2: value2 

c'è un bug relativo con il mime-type, non è possibile utilizzare i punti ecco perché non l'ho fatto put application/vnd.api + json