NSwag - предоставить дополнительную информацию для ожидаемых данных в действии контроллера

Question

У меня есть действие контроллера, который принимает данные в виде массива объектов (сложный объект называется ControlLinePointDto). По причинам, описанным в моем вопросе и ответе здесь, я прочитал это в JArray а не ControlLinePointDto[], Я делаю это в нескольких местах с разными объектами.

Как я могу изменить документацию (NSwag) так что это задокументировано (включая пример) как ControlLinePointDto[], скорее, чем []?

[HttpPost("AddPoints")]
[ProducesResponseType(typeof(List<ControlLinePointDto>), 200)]
public async Task<IActionResult> AddPoints(int ControlLineId, [FromBody] JArray pointSetJson){
}

Answer 1

Вы можете изменить тип документа следующим образом:

[JsonSchemaType(typeof(MyDto[]), FromBody] JArray array

https://github.com/RSuter/NJsonSchema/blob/master/src/NJsonSchema/Annotations/JsonSchemaTypeAttribute.cs#L19