Web API设计：表单POST'ing键值对：JSON还是复选框样式？

Question

RESTful API的设计问题：API的输入参数（即，从客户端发送到API的数据）之一是字典（哈希/键值对）。 最好的编码方式是什么，以便可以轻松地从网页以及脚本/编程语言中调用API？

我的第一个想法是对对象进行json编码，如下所示：

var data = {a:'one', b:'two'};
form_paramter_x = JSON.stringify(data);

并在服务器上解码：

data = simplejson.loads( request.POST['form_paramter_x'] )

另一种方法是将其编码为键值对html-form-checkbox样式：

form_param_x=a:one&form_param_x=b:two

后一种选择将需要对键和值（“ a：one”部分）进行临时解析，并且通常看起来不太干净，但看起来也更接近基本的HTML形式，这可能是一件好事。

其中哪个更清洁？ 还是有另一个更好的选择？

Answer 1

如果您正在设计供其他方使用的API，我会考虑对他们来说最容易编码的是什么。 如今，JSON已得到广泛支持，因此这并不会破坏交易。 最后，我会选择您的客户更容易编写的代码。 从情感上讲，我倾向于JSON编码。