假设我有一个包含人员列表的网站。当通过浏览器访问“人”资源时,服务器会以 HTML 格式返回该资源的数据。但是,如果我还想通过计算机使该资源可消耗,那么允许客户端以 JSON 格式而不是 HTML 格式请求数据的首选方法是什么?
我现在可以想到三种方法可以实现这一点。
1.) 我见过许多网站通过子路径(例如,/api/people/john-doe
)打开他们的 API,但这似乎是反休息的,因为它为同一资源创建了多个端点。
2.) 另一种方法是传入查询字符串参数(例如,/people/john-doe?format=json
),但这是正确的地方吗?
3.) 可以在请求中使用自定义 HTTP 标头,例如:X-Response-Format: json
. 这对我来说似乎是最干净的方式,但同样,不确定它是否适合它。