问大家一个接口设计的问题,比如获取用户列表,有两个需求:1:获取全部用户列表2:以分页形式获取用户列表大家一般会把接口设计成什么样的?按照我之前的习惯:获取单个用户GET/users/:id在有需求1时,我把接口设计为:GET/users但是当遇到需求2时,本来打算设计为GET/users参数:page、pageSize。如果传入pagepageSize即为分页,否则默认不分页。但是此时有个需求,如果客户端没有传入,希望后端默认有个分页(是有这么个鬼畜的需求,历史遗留问题),所以此时API设计就不能只用/users,会发生冲突。想问一下大家,这种情况下需求2如何设计API呢?
2 回答
撒科打诨
TA贡献1934条经验 获得超2个赞
已有分页接口的话,个人倾向于不再提供获取全部的接口。如果这个“获取全部”有最大数量限制,那么调用分页接口设置页码为1,分页大小为限制值即可;如果“没有限制”,那就传个1<<30(1073741824)吧。你问要是用户数大于1<<30怎么办?500万个手机号码的文本都有将近60MB大小了,超过10亿的用户信息……,你确定要通过接口一次性传输那么多数据吗,服务器吃得消吗?网络吃得消吗
添加回答
举报
0/150
提交
取消