支持手机和web页面接口的设计

Question

在做一个项目，有手机端和web端。功能是一样的。现在有个疑问 设计接口的时候是统一返回json格式的数据呢？还是通过一个参数from=web或者mobile来返回不同的响应。手机返回json格式的数据。web将数据存入response中然后页面从response中，然后web前端通过freemarker或者velocity来生成页面？因为查询参数等是一样的所以没别要弄两个接口但是怎么设计这个接口呢犯难了？希望大家提点建议，非常感谢。

ps:freemarker等也能在前端解析JSON，但还是纠结怎么设计。

Answer 1

你就看一下sf的回复自动保存草稿请示

http://segmentfault.com/api/user?do=stat&_=046e6ec678c0aab5b5b5f070159198a1

现在常规比较流行的是在平常说的后端里再分二层，后端中的前端+后端中的后端，手机直接调用后端中的后端，网站调用后端中的前端，这个前端再去调用后端，这个后端也就是api服务器，遵守restful风格。手机与网站完全共用接口肯定不行，这样会很麻烦，而且后期手机版本升级，你可能要改成 http://segmentfault.com/v2/api/user?do=stat,这样你怎么兼容

Answer 2

api端返回json数据，web端和mobile端通过ajax取数据，用js渲染界面。

如果考虑到手机端的网络状况不适合大数据量传输（一次的json数据大小达到500k以上），那么可以考虑在设计接口时分mobile端和web端，而且mobile端可能需要设计缓存，不过这要看情况。