从REST API返回二进制集合的最佳实践

Question

我想知道在构建我的网址时最好的做法是什么，以及到浏览器的传递可能是我的问题。我浏览过一些与此相关的帖子，但都不合适。

我的用户可以选择多个项目，并请求一个pdf全部（在这种情况下的发票 - 我返回一个PDF，每个发票都有一个页面）。

RESTful方法是什么？我的pdf是动态生成的，所以我没有资源指向他们。此外，在我看到的与此相关的大多数帖子中，它涉及为单个资源而不是集合返回pdf。

我的API看起来像这样：

GET /api/orders // all orders
GET /api/orders/123  //123 order
GET /api/orders/invoice?ids=123,456 // Return a PDF of 2 orders to browser

对这种方法不太满意。建议？

Answer 1

  

我的pdf是动态生成的，所以我没有资源指向他们。

我不同意这一点。资源不必在物理上存在，它是一个逻辑实体。我喜欢你的API。