RESTFul：如何指定POST请求体格式？

Question

我正在使用RESTFul API并拥有一个允许JSON或CSV正文内容的POST方法。

处理此问题的最佳方法是什么？是应该使用URL路由/参数（例如/resource/json还是/resource/?type=json），还是通过标头（因此URL只是/resource而标头会指定json或csv）？

Answer 1

根据W3C（https://www.w3.org/Protocols/rfc1341/4_Content-Type.html）的正确方法是使用Content Type标头指定正确的类型。

• 对于json，它将是Content-Type: application/json
• 对于文字CSV，它将是Content-Type: text/csv

避免使用url params。虽然这不是“非宁静”，但这不是业余时间推荐的方法和气味。更糟糕的是创建一个新的“资源”，它只是现有资源的一种表示。