Modèle de réponse contenant un tableau de différents types d'objet dans swagger

Question

Je veux modéliser un objet de réponse contenant un tableau de différents types d'objets dans swagger, quelque chose comme ça:

{
   "table": [
        {
          "user" : []
        },
        {
          "customer": []
        },
        {
           "employee": []
        }
    ]
}

J'ai essayé une solution ci-dessous mais elle regroupe toutes les propriétés dans un seul objet { [ { "user": [], "customer": [] } ] }.

  réponses:
    200:
      schema:
        type: tableau
        éléments:
          type: objet
          propriétés:
            user:
              type: tableau
              éléments:
                $ref: '#/définitions/User'
            customer:
              type: tableau
              éléments:
                $ref: '#/définitions/Customer'
            employee:
              type: tableau
              éléments:
                $ref: '#/définitions/Employee'

Answer 1

Cela sera pris en charge dans la prochaine version de la spécification OpenAPI (3.0) et voici la discussion associée à cette fonctionnalité:

https://github.com/OAI/OpenAPI-Specification/issues/57

Voici un exemple (fourni dans l'URL ci-dessus):

{
  "oneOf": [
    { "$ref": "Cat" },
    { "$ref": "Dog" }
  ]
}