У специфікації swagger я визначаю схему об'єкта, який повертається запитом. Це дуже добре для GETs, але якщо у мене є кінцева точка POST, вона може мати той самий об'єкт у ньому. json.schema для "параметрів", які POSTed до кінцевої точки? Тобто роблять a $ref: #/definitions/myObject? Смутно було б визначити схему двічі, один раз для вхідних і один раз для вихідних.
І тоді можливо, щоб проміжне програмне забезпечення перевірило корисне навантаження повідомлення проти цього json.schema і відхилити, якщо корисне навантаження не відповідає?
Здається, що всі фігури доступні, так що тепер мені цікаво, якщо вона була зібрана разом чи ні.
Відповіді:
0 для відповіді № 1Гаразд, мабуть, я не можу відкрити нічого, перш ніж відправляти в розпачі. Але я знайшов його.
У документах дивно. Paramnerters. Якщо ви оголосите тип параметра "body", ви можете / повинні оголосити тип схеми. Як у json.schema. Отже, перша частина.
Тоді для другої частини є проміжне програмне забезпечення для вузла в swagger-tools що перевіряє запит і, при необхідності,відповідь. Хоча це не зовсім ясний, я вважаю, що він перевірить тіло проти схеми, так що це досить здорово. Я не знаю, які повідомлення про помилки він генерує, сподіваюся, що-небудь, що можна налаштувати або хоча б зрозуміло.