Array of Multiple items in Swagger

Question

Итак, я создаю конечную точку пользователя с nodejs, чтобы добавить пользователя в базу данных, а для документации api я использую редактор swagger, и я совершенно новичок в этом. то, что я хочу сделать, это добавить пользователя с логином, паролем, аватар, но что пользователь имеет несколько ролей, которые я хочу, чтобы добавить в базу данных то, что я сделал в документе YAML в редакторе развязность это

/users/add: 
post: 
description: '' 
operationId: AddUser 
parameters: 
- description: The user login 
    in: formData 
    name: user 
    required: true 
    type: string 
- description: The user password 
    in: formData 
    name: password 
    required: true 
    type: string 
- description: The user name 
    in: formData 
    name: username 
    required: true 
    type: string 
- description: The user avatar 
    in: formData 
    name: avatar 
    required: true 
    type: file 
- in: formData 
    name: roles 
    description: roles 
    required: false 
    type: array 
    items: 
    type: string 
    collectionFormat: multi 

и это своего рода отображение того, что я хочу в редакторе развязность

но то, что я получаю в пользовательском интерфейсе только поле ввода

в заключение я хочу, чтобы это введенный массив, который содержит пользовательские роли и вводит их в базу данных. Спасибо

Answer 1

Какую версию пользовательского интерфейса Swagger вы используете? Я на версии 2.1.1, и когда я ставлю то же определение, что и я, я получаю следующее поле ввода для поля массива.

Попробуйте обновить до последней версии Swagger UI.

Кроме того, если вы обновите «в» поле, чтобы быть «запрос» в результате URL будет выглядеть следующим образом:

http://localhost:8080/accounts?roles=admin%2Cguest%2Cuser

Вы можете получить доступ к значениям массива в параметрах URL, а не в "FormData".