RESTful API:“下载资源”端点名称

Noa*_*oam 2 rest

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

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

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

我已经有:

[GET] /files/file-id
Run Code Online (Sandbox Code Playgroud)

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

McG*_*V10 6

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

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