Параметры Swagger и сложные типы

Question

В следующем определении Swagger мне нужен параметр labelValue типа LabelValueObject, так что он будет проверен и правильно десериализован. Однако я не могу понять синтаксис! Как это можно сделать?

swagger: "2.0" 

paths: 
    /competition: 
    post: 
     parameters: 
     - name: labelValue 
      in: formData 
      type: array 
      items: 
      type: string  ### this has to be a LabelValueObject ### 
     responses: 
     default: 
      description: Error 
      schema: 
      $ref: "#/definitions/AnyResponse" 

definitions: 
    AnyResponse: 
    properties: 
     any: 
     type: string 
    LabelValueObject: 
    properties: 
     label: 
     type: string 
     value: 
     type: string 
    required: 
     - label 
     - value 

Answer 1

Единственный способ передать объект в качестве параметра, чтобы поместить его в организме (in: body), а затем определить этот объект в schema (определении инлайн или ссылку на предопределенный объект с $ref). Вот полный пример:

swagger: "2.0" 

info: 
    title: A dummy title 
    version: 1.0.0 

paths: 
    /competition: 
    post: 
     parameters: 
     - name: labelValue 
      in: body 
      schema: 
      $ref: '#/definitions/LabelValueObject' 
     responses: 
     default: 
      description: Error 
      schema: 
      $ref: "#/definitions/AnyResponse" 

definitions: 
    AnyResponse: 
    properties: 
     any: 
     type: string 
    LabelValueObject: 
    properties: 
     label: 
     type: string 
     value: 
     type: string 
    required: 
     - label 
     - value