此用例的 REST API 模式答案

【问题标题】：REST API pattern for this usecase此用例的 REST API 模式
【发布时间】：2017-01-23 22:49:34
【问题描述】：

我需要通过 AJAX 调用来实现这一点，其中一个方便的帮助函数（在服务器上）可以解决问题，但是 REST 的实现方式是什么？

我在浏览器端有一个项目（猫）列表，我需要为所有这些项目填充另一个详细信息。

input = [list of cat ids]
output = [list of {}s which has cat ids & age]

如果我不需要关心正确的 REST API，我只需声明一个方法 populate_cat_details() 并通过返回 JSON 的 GET http://example.com?method=populate_cat_details&cat_ids=1,2,3,4 调用它

【问题讨论】：

这太宽泛了。 “过于宽泛、不清楚、不完整或主要基于意见的问题在得到改进之前可能会被put on hold by the community。”参见What topics can I ask about

标签： rest api api-design

【解决方案1】：

GET http://www.example.com/cats    -> return all cats
GET http://www.example.com/cats/:id    -> return 1 cat by id
GET http://www.example.com/cats?id=x&id=y&id=z -> return n cats matching ids
GET http://www.example.com/cats?age=2&age=3&age=4  -> return n cats matching ages 
GET http://www.example.com/cats?id=x&id=y&id=z&age=2&age=3&age=4  -> return n cats matching ids and ages

如果传递逗号分隔值之类的参数，您还有其他方法，例如：ids=1,2,3

看看这里： http://www.restapitutorial.com/lessons/restfulresourcenaming.html

【讨论】：

所以想法是，为输入列表获取猫的完整详细信息，它不仅限于年龄，因为它包括所有其他属性。在某种程度上，我会说这是一个很好的答案。尽管它将不需要的详细信息传输到客户端/浏览器。