REST API设计：如何定位所有资源的属性

Question

假设我们有以下GET：

/agents <--returns all agents
/agents/5 <-- returns data for agent id 5
/agents/5/status <-- returns status for agent 5

如何编写RESTful URI以获取所有代理的状态？ 具有/ status不会执行此操作，因为其他资源也具有状态。 我想要类似的东西：

/agents/*/status <-- never seen this

但找不到类似的东西。 现在我有这个：

/misc/agentsstatus <-- not pretty

UPDATE ：怎么样：

/agents <--returns all agents
/agents(5) <-- returns data for agent id 5
/agents(5)/status <-- returns status for agent 5
/agents/status <-- returns status for all agents

Answer 1

如何编写RESTful URI以获取所有代理的状态？

REST不关心拼写-纯粹是URI设计方面的问题。

参见： https : //softwareengineering.stackexchange.com/questions/270898/designing-a-rest-api-by-uri-vs-query-string

如果您希望URI的拼写将语义传达给人类读者，则可以证明是合理的

/agents?embed=agent.status

当前代理程序集合的表示形式，其中包括代理程序状态的表示形式

/agents/agent.status

从属当前agent集合的当前agent.status资源集合的表示

/agents/digest

当前代理集合的摘要表示

/reports/agentStatusReport

当前agentStatusReport的表示形式