【发布时间】:2012-10-24 22:57:18
【问题描述】:
我正在请求(通过Accept: application/json)我正在设计的 API 以 JSON 响应。但是,我希望将 JSON 中的值指定为符合 text/plain 或 text/html,具体取决于客户端的功能。
“子类型”的 RESTful 最佳实践是什么?如果我正式切换到 HAL 作为顶级容器,这将如何工作?
接受:application/json+text/plain
{
"value": "Hello World"
}
接受:application/json+text/html
{
"value": "<h2>Hello World</h2>"
}
【问题讨论】:
-
"RESTful" 与这个问题无关。您只需使用您可以接受的类型指定
Accept:标头。除非您知道服务器专门提供它们,否则我会很担心添加像application/json+txt/html这样的非标准后缀。任何高质量的 API 都应该清楚地记录可用的内容类型。 -
完全正确,我可以简单地说 HTTP。我正在设计 API,并试图为客户找到最接近标准的做法,以便就该主题与服务进行通信。
application/json+txt/html是我提出的几个非常尴尬的解决方案之一,但我认为它具有说明性。
标签: http rest content-type