Документирование отношений многих со многими с Swagger - PullRequest
Новая
       24

Документирование отношений многих со многими с Swagger

0 голосов
/ 08 октября 2019

Я создаю приложение Rails, которое является только API, и документирую API, используя Swagger UI Это работает очень хорошо, но я не могу понять, как добавить отношение has_and_belongs_to_many. 

class Location
  has_and_belongs_to_many :suppliers
end

class Supplier
  has_and_belongs_to_many :locations
end

Теперь я вижу другие «исключительные» отношения, представленные внутри хеша «отношения» с типом «объект» и «свойства», заданными как ссылки.

Человек имеет одну этническую принадлежность:

"relationships": {
  "type": "object",
  "properties": {
    "ethnicity": {
      "$ref": "ethnicity_reference.json#/EthnicityReference",
      "description": "Person's ethnicity"
    }
  }
}

Но я, по-видимому, не могу понять, как представить отношения многих ко многим, и пока не смог найти ни одного примера. У кого-нибудь есть указатель или предложение?

...