REST API 设计：返回报告的端点

Question

我需要创建一个返回某种形式的报告的端点。就像是： api-v1/report?format=XML。它使用自定义 XML 报告进行报告。 万一xsl怎么办？ api-v1/report?format=XSL用XSL(Excel)文件回答这样的请求正常吗？

Answer 1

资源（数据）应该独立于格式/编码 是否是xml、json、xls、csv等应该通过“内容协商”来确定，通常使用“accept”头来完成。

Answer 2

一种解决方案是使用可以从何处下载文件的 URL 进行响应，而不是发送文件的内容。