c# - REST Web 服务 - 获取和创建的不同类型

Question

使用 ASP.Net Web Api，您的 GET 端点返回与 POST 端点接受的类型不同的类型是否正常/良好做法？

在很多情况下，我们想要在 GET 中返回的字段不能在 POST 中设置，例如“LastUpdated”、“Total”等，需要不同的类型吗？

例如，GET 返回 ReservationForGetModel，而 POST 接受 ReservationForCreateModel:

public class ReservationController : ApiController {
...

  public HttpResponseMessage Get(int id) {
    Reservation reservation = _reservationService.Get(id);
    //map Reservation to ReservationForGetModel
    //return ReservationForGetModel
  }

  public HttpResponseMessage Post(ReservationForCreateModel reservation) {
    //create reservation using ReservationForCreateModel here
    //return 201 with location header set
  }

}

Answer 1

GET 和 POST 可以使用完全不同的媒体类型。考虑 HTML 表单:您使用 application/x-www-urlencoded-form 进行 POST，GET 返回 text/html。

对于 GET 和 PUT，媒体类型更有可能是对称的，但这不是硬性规定。