RAML-如何使用参数设计端点？

问题描述

我需要使用RAML设计此规范：

Resource: quantity

Method: GET

URL: {orderId}/{itemId}/quantity

目标是在URI中传递orderId和itemId并获取数量。我是这样设计的：

/{orderId}/{itemId}/quantity:
  get:

以这种方式设计资源是最佳实践还是有更好的方法？

解决方法

通过提供订单和商品之间的关系（如集合和单个数据），这样的事情将更加RESTful：

/orders:
  /{order_id}:
    /items:
      /{item_id}:
        get:

quantity应该是响应正文中的一个字段。