用于下载的REST方法

时间:2015-11-06 11:21:03

标签: api rest download downloading

我们的API将允许用户下载文件(10mb - 500mb)。

REST端点将是

/downloads/*content-id*

其中内容标识是对我们服务器上文件的引用。

我认为HTTP方法应该是GET,因为它试图检索某些东西。但是,由于我希望用户能够暂停下载以便稍后恢复,因此我还需要将一个字节接收的参数传递给端点。

我应该将其作为查询参数吗?

/downloads/*content-id*?bytesReceived=123

或者我应该将收到的字节数添加到请求正文中,如果是,我是否应该再使用GET?

另外,作为第二个q。我正在使用八位字节流内容类型来下载文件 - 因为我被告知这种内容类型最好让我暂停下载并稍后恢复。解压缩时,该文件将是一些HTML5内容(使用js / css)。这是最好的方式吗?

1 个答案:

答案 0 :(得分:0)

您应该使用GET方法,因为您获得了特定资源。由于bytesReceived没有正文,因此您无法通过正文传递GET。取而代之的是使用名为Range的合适标题,请参阅here