在RESTful架构中，客户端应该如何请求使用资源的格式？

Question

假设我有一个包含人员列表的网站。当通过浏览器访问“person”资源时，服务器以HTML格式返回该资源的数据。但是，如果我还想通过计算机使该资源可以使用，那么允许客户端以JSON格式而不是HTML来请求数据的首选方法是什么？

我现在可以通过三种方式来实现这一点。

1。）我见过许多网站通过子路径（例如/api/people/john-doe）打开他们的API，但这似乎是反宁静的，因为它为同一资源创建了多个端点。

2.。）另一种方法是传递查询字符串参数（例如，/people/john-doe?format=json），但它是否适合它？

3.。）可以在请求中使用自定义HTTP标头，例如：X-Response-Format: json。这对我来说似乎是最干净的方式，但同样，不确定它是否适合它。

Answer 1

我很快发现谷歌后正确的方法是Accept标题。