Swagger определение заполнителя? - PullRequest
0 голосов
/ 04 февраля 2019

Я создаю спецификацию swagger и застрял в части определения, главным образом для представления определения PagedResult, см. Ниже:

definitions:
  PagedResult:
    type: "object"
    properties:
      count:
        type: "integer"
      next:
        type: "string"
      previous:
        type: "string"
      results:
        type: array
        items: <placeholder>?
  Device:
    type: "object"
    properties:
      type:
        type: "string"
      id:
        type: "string"

Элемент results определения PagedResult является общим для любого определенияКак мне указать его в ответах API, чтобы ввести определенный тип в элементы results?Например,

paths:
  /machines:
    get:
      operationId: "getMachines"
      consumes:
      - "application/json"
      parameters:
      - name: "customer"
        in: "query"
        description: "Get machines by customer"
        required: false
        type: "string"
      responses:
        200:
          description: "successful operation"
          schema:
            type: "array"
            items:
              $ref: "#/definitions/PagedResult" <----- how to inject Device definition here?

Я читал о повторном использовании определений, но, похоже, мой случай противоположен.И я не хочу копировать вставить PagedResult для каждого определения.

Добро пожаловать на сайт PullRequest, где вы можете задавать вопросы и получать ответы от других членов сообщества.
...