ASP.NET 核心 WebAPI 3.1 多参数与复杂对象 httpget

Question

一段时间没有完成 API，并希望确保当您需要在HttpGet中传递多个参数时，进行调用的最佳实践是什么

选项 1

[HttpGet("getpet", Name = nameof(GetPet))]
[ProducesResponseType(typeof(PetResponse), (int)HttpStatusCode.OK)]
public async Task<ActionResult<<PetResponse>> GetById(
[FromQuery]int id,
[FromQuery]bool dogsOnly)

选项 2 使用复杂对象。

[HttpGet("getpet", Name = nameof(GetPet))]
[ProducesResponseType(typeof(PetResponse), (int)HttpStatusCode.OK)]
public async Task<ActionResult<<PetResponse>>  GetById([FromQuery]PetRequest request)

公开课宠物请求 { public int Id { get; set; } public bool DogsOnly { get; set; } }

对任何方法(例如在邮递员中进行测试(的任何建议或限制？

Answer 1

任何方法的任何建议或限制，例如在 邮差？

这两个选项使用相同的方式在邮递员上进行测试。

如果您的查询字符串不会更改，则这两个选项都是可以接受的。但是，如果之后需要更改查询字符串，并且相同的查询字符串在应用程序中多次出现，则创建PetRequest模型要好得多。