RESTful API : "download resource" end point name

标签 rest

关闭。这个问题是opinion-based .它目前不接受答案。












想改进这个问题?更新问题,以便 editing this post 可以用事实和引用来回答它.

4年前关闭。




Improve this question




我正在构建一个 RESTful api,它应该支持 GET 请求以下载服务器资源之一(一个文件)

我想知道我应该给出这个请求的正确名称(路线)是什么(假设有一个)。

我已经阅读了一些我发现的“最佳实践”文章,但没有一篇与这种情况无关。

我已经有:

[GET] /files/file-id

它返回有关文件的信息,所以我需要别的东西。
RESTful 下载请求是否有最佳实践?

最佳答案

Accept header 应该控制您的端点返回的内容。例如,如果 header 请求 XML 或 JSON,则将返回文件信息,但如果 header 请求类似 base64 或通用二进制类型 application/octet-stream ,通常会返回文件本身。

这就是“代表性”在 REST 中的含义。没有什么能真正返回资源本身(理论上)——您根据客户端的请求返回资源的表示。

关于RESTful API : "download resource" end point name,我们在Stack Overflow上找到一个类似的问题: https://stackoverflow.com/questions/48250239/

相关文章:

java - Tomcat 的 JAX-RS 异常

java - 为什么要使用 REST @Produces 注解

java - 配置 Spring RestTemplate

rest - SoapUI 是否能够以 html 形式发送剩余请求?

asp.net-mvc - MVC3 RESTful API 路由和 Http 动词处理

python - 为 Web 应用程序使用的 Python REST API 选择适当的身份验证类

c# - WCF REST 入门工具包 - 名称为 'UriTemplateMatchResults' 的属性已存在

java - 如何在 REST 服务中获取不同 mime 类型的 Map 参数?

node.js - 如何创建通过特定参数过滤搜索的查询字符串?

ajax - 将 REST API 响应显示为内联 pdf(未下载文件)