如何命名非常具体的rest-api端点？

Question

假设我正在制作一个REST API，它具有两个基本实体，音频和艺术家

基本端点为：

(GET)  /audios          -> Get all Audios
(GET)  /artist/4        -> Get the Artist with ID 4
(GET)  /artist/4/audios -> Get all audios of artist 4
(POST) /artist          -> Create an Artist
...

但是，当涉及到非常具体的请求时，例如艺术家4发布的最后3个音频或艺术家4的最近收听的音频]，命名这种端点的正确方法是什么？

假设我正在制作一个具有两个基本实体（音频和艺术家）的REST API，基本端点是：（GET）/ audios->获取所有音频（GET）/ artist / 4->获取...

Answer 1

由于您已经有一个明确定义的资源层次结构，因此建议您使用查询参数，例如艺术家4的最后3个音频

-/ artist / 4 / audios？recent = 3。至于艺术家4的最常收听的音频