paths: api.v1.positions: get: summary: repo.find() Возвращает полный список должностей description: Для разных организаций должности могут повторяться. Предусмотреть пагинацию при получении должностей, список может быть огромным responses: '200': description: Получение списка должностей content: application/json: schema: $ref: "../components.yaml#/components/schemas/position" post: summary: repo.create() Создает в базе запись о новой должности description: Предварительно должна существовать организация. Должность привязываетс для каждой организации, для разных организаций должности могут повторяться. requestBody: content: application/json: schema: type: object required: - name - organization properties: name: type: string organization: type: object properties: id: type: integer responses: '200': description: OK content: application/json: schema: $ref: "../components.yaml#/components/schemas/position"