这两种api设计方式，你喜欢那种？
那种是“正确”的？
This topic created in 4675 days ago, the information mentioned may be changed or developed.
这两种api设计方式，你喜欢那种？
那种是“正确”的？
 |
familyJan 23, 2014
1
没有“正确”✅吧
“友好”就行 |
 |
dialoxJan 23, 2014
2
从可读性上看，方法1比较好，可以用“key”来描述参数的含义。另外，方法1也方便未来在接口调用的时候增加参数。
|
 |
saricesJan 23, 2014
3
可以这样，默认value2参数为空，然后必须填写第一个参数，如果第一个参数为数组即表示使用数组传参数
|
 |
akiraJan 23, 2014
4
参数数量多，用第一种；参数数量少，用第二种。例如只有一个参数，写key什么的就很多余了。
PS : 两种格式同时支持又不是不行。。。 |
 |
alex321Jan 23, 2014
5
方法 1 是传递的数组，扩展性很好。
is_array($temp)/////// |
 |
judasnowJan 23, 2014
6
倾向于第一种，便于参数合法性的检查。
|
 |
issacJan 23, 2014
7
第一种清晰,容易理解;
其实用JSON更方便; |
 |
dorentusJan 23, 2014 via iPhone
8
没有实际场景，没法说哪种是「正确」的。
如果你不确定的话，可以自己作为自己的用户，做个小项目实际使用一下自己提供的 API 看看感受。 |
 |
9
|
 |
10
个人习惯是，设计一个API，其参数分为2类。
第1类是没它不可的，这一类就直接传递，不放在array中 第2类是可有可无的，属配置项，放在array中 举个例子(javascript)： findUserById(id, { includeDisabledUsers: true }) 这个方法既然叫ById了，id显然是要提供的，因此id显式传递，后面的includeDisabledUsers是有默认值（false）的，不传也没问题，因此放在一个对象中作为配置项。 这样的好处是你不会少传了什么导致API不能调用，又保留了可扩展性，需要额外的配置项可以在对象里加 |
2
Select Language