编写休息终点的好练习是什么？

Question

我想添加一个休息端，以增加酒店中某些房间的预订。更好的方法是什么？我有2个解决方案：

@RequestMapping("api/v1/hotels/hotelId/rooms/roomId/reservations")
some Class Endpoint

    @PostMapping
    public ReservationApi save(final @RequestBody ReservationApi reservationApi,
                               final @PathVariable("hotelId") String hotelId,
                               final @PathVariable("roomId") String roomId) {
        final Reservation reservation = reservationMapper.toDomain(reservationApi);
        return reservationMapper.toApi(reservationService.save(reservation, hotelId, roomId));
    }

并且在服务方面构建保留：

或者我有一个不使用路径的替代解决方案，仅使用API​​类来创建：

@RequestMapping("api/v1/reservations")

    @PostMapping
    public ReservationApi save(final @RequestBody ReservationApi reservationApi) {
        final Reservation reservation = reservationMapper.toDomain(reservationApi);
        return reservationMapper.toApi(reservationService.save(reservation));
    }

Answer 1

评论中的建议肯定会有所帮助。我建议拨打呼叫服务类以进行实施。您可以在控制器类中自动自动化服务类，然后实现功能。此外，我可以建议您可以使用响应对象发送响应。

Answer 2

我认为这毕竟取决于数据库的结构，尽管遵循纯粹的休息规则，但我会选择选项1，为什么？因为如果我想以后查看房间的预订清单，我会使用与用来为该房间创建预订的相同端点。

此外，我们不知道Reservationapi中有什么 - 我们还提供了那里的酒店ID和房间ID，还是仅提供预订所需的信息？

我值得创建保留响应，我会选择选项1

我同意以前的评论，即如果我必须创建这样的API，