RESTful最佳实践-如何命名报表资源_Rest_Api_Design Patterns

RESTful最佳实践-如何命名报表资源

rest api design-patterns

RESTful最佳实践-如何命名报表资源,rest,api,design-patterns,Rest,Api,Design Patterns,我正在创建一个RESTful API并遵循它的最佳实践，对此我产生了很大的怀疑我需要创建一个报告（带有图表和数据表），它由分析其他资源（评估）和许多其他参数组成，使该报告在显示的数据上可变因此，在寻找最佳实践时，我不知道是否需要获取所有数据，并在Javascript中进行处理，以生成报告（客户端），从而使RESTful模式不成问题或者如何命名由许多其他资源组成的资源“报告”。我不安的头脑想要创建一个/api/rest/reports/executiveReport？evaluation=：

我正在创建一个RESTful API并遵循它的最佳实践，对此我产生了很大的怀疑

我需要创建一个报告（带有图表和数据表），它由分析其他资源（评估）和许多其他参数组成，使该报告在显示的数据上可变

因此，在寻找最佳实践时，我不知道是否需要获取所有数据，并在Javascript中进行处理，以生成报告（客户端），从而使RESTful模式不成问题

或者如何命名由许多其他资源组成的资源“报告”。我不安的头脑想要创建一个

/api/rest/reports/executiveReport？evaluation=：id&competencies=：id&competencies=：id&employee=：id

uri

如何在一个漂亮的RESTful模式uri中实现这一点？我不想用Javascript处理数据，因为有很多错误或异常我无法捕捉。我更愿意提交要展示的报告

谢谢

所以我实现了一个名为

api/rest/report

的报告端点，然后我有三个报告：

```
api/rest/report/executive
```
```
api/rest/report/detailed
```
```
api/rest/report/datatable
```

每个端点都有自己的过滤器，如参数：

api/rest/report/executive?uuid=12345&competences=65424&competences=454124&comparativeGroup=12354&comparativeGroup=98457

我最近做了一件事，我使用了主要的“主题”作为资源。我有像

。/stats/projects

和

。/stats/tasks

这样的端点。参数有适当的不同。您不能执行类似的操作：

。/reports/executive

？您可以通过将类路径设置为/report，然后为每种类型的报告（如/executive）指定特定的方法来实现这一点。这样，您的API对于每种报告类型都是灵活的。假设执行报告采用2个参数，但其他一些报告采用3个参数。