REST API返回JSON/XML以外的内容是否可以接受？

Question

我目前正在尝试构建一个REST端点，通过认证的用户可以下载PDF。在研究这样做的正确方法时，我主要看到JSON或XML是适当的响应主体。然而，this网站解释说，只要它是一些人类可读的文档，响应可以是JSON以外的内容。

那么，REST API可以将application/pdf作为响应类型而不是application/json或application/xml返回吗？

Answer 1

是的，绝对的，一个RESTful API可以返回任何想要的东西。没有任何限制是人类可读的（尽管我认为链接的文章试图辩论完全相反）。想想基于REST的Web，返回图像，电影，有时甚至是可运行的代码。

然而有一些约束。任何返回的表示都应该是“自包含的”，这意味着它必须拥有客户端所需的每一条信息。在这种情况下，它基本上是指在响应中正确设置“application/pdf”类型。