IRI作为过滤资源的参数

Question

我们使用IRI来识别API中的重新源。当我们想要用重新源过滤另一个重新源时，我们必须使用IRI的ID部分。这正常吗？

例：

GET /api/authors
[{
  @id: "/api/authors/45gfd654d",
  name: "John Doe",
}]

GET /api/books?authors=[45gfd654d]

使用起来似乎很复杂，因为我们必须拆分IRI才能在其他API调用中使用最后一部分。我的问题是:在这种情况下，的指导方针是什么？重新源必须有一个id (只有最后一个IRI部分)，或者我们允许使用IRI?进行筛选。

谢谢

Answer 1

真的很痛！我们选择尝试并在查询参数中实际使用(相对) uris。

在许多情况下，我们还将创建像/api/authors/[id]/books这样的专用端点。虽然最终相似，但我们的客户从未构建或解构urls。Urls被发现，因此客户端将在作者资源上找到“图书列表”链接。