Опишите содержимое файла в swagger - PullRequest
1 голос
/ 30 марта 2020

Я работаю над документированием существующих API в swagger, используя спецификацию open api 3.0.0. Я хотел бы понять процедуру документирования содержимого файла, который должен быть загружен. Например,

Скажем, файл, который должен быть загружен, является ответом. json, и он имеет следующее содержание: {name: xyz, age: 50}

Я хотел бы знать процедура документирования вышеуказанного JSON, чтобы клиенты, использующие наш API, предоставили файл в указанном выше формате JSON.

...