=== 1.基本约定 === {{{ 1.当接口处理正常时,HTTP STATUS CODE 返回给200。包括有正常的业务数据和数据为空的情况。 2.当接口处理异常时,HTTP STATUS CODE 返回给500,并且给出具体的错误信息。 { "uri" : "/intf/albums-by-type.jsp", "error-desc":"Need you follow uid.", "user-notice":"给用户的提示放在这里" } 3.接口默认的字符编码是UTF-8,接口需要实现对req-enc和resp-enc参数的支持。在JSP的最顶部,实现类似下面的代码: String queryString = request.getQueryString(); String requestEncoding = getParam(queryString,"req_enc"); String responseEncoding = getParam(queryString,"resp_enc"); if(isNotBlank(requestEncoding)){ request.setCharacterEncoding(requestEncoding); } if(isNotBlank(responseEncoding)){ response.setCharacterEncoding(responseEncoding); } 4.所有有写操作的数据接口,必须用POST方式提交,在接口里需要判断提交方式,拒绝GET的调用请求。 5.接口中的JSON字符串,key都用双引号("")包裹,value是字符串类型时,也用双引号("")包裹;是数字类型时,不用引号。 }}} == 2.接口列表 == === 2.1 [=#point201 资讯栏目]=== {{{ 参考:http://trac.pc.com.cn/iphone/wiki/pcauto_pconline_4.0.0/intf#point202 }}} === 2.2 [=#point202 同步内容下载]=== {{{ 参考:http://trac.pc.com.cn/iphone/wiki/pcauto_pconline_4.0.0/intf#point206 }}} === 2.3 [=#point203 同步内容上传]=== {{{ 参考:http://trac.pc.com.cn/iphone/wiki/pcauto_pconline_4.0.0/intf#point207 }}} === 2.4 [=#point204 帖子页]=== {{{ 参考:http://trac.pc.com.cn/iphone/wiki/pcauto_pconline_4.0.0/intf#point210 }}} === 2.5 [=#point205 帖子列表]=== {{{ 参考:http://trac.pc.com.cn/iphone/wiki/pcauto_pconline_4.0.0/intf#point209 }}} === 2.6 [=#point206 帖子页回复楼层]=== {{{ 参考:http://trac.pc.com.cn/iphone/wiki/pcauto_pconline_4.0.0/intf#point211 }}} === 2.7 [=#point207 图集列表]=== {{{ 参考:http://trac.pc.com.cn/iphone/wiki/pcauto_pconline_4.0.0/intf#point214 }}} === 2.8 [=#point208 专栏]=== {{{ 参考:http://trac.pc.com.cn/iphone/wiki/pcauto_pconline_4.0.0/intf#point219 }}} === 2.9 [=#point209 文章]=== {{{ 参考:http://trac.pc.com.cn/iphone/wiki/pcauto_pconline_4.0.0/intf#point220 }}} === 2.10 [=#point210 获取用户信息]=== {{{ 参考:http://trac.pc.com.cn/iphone/wiki/pcauto_pconline_4.0.0/intf#point225 }}} === 2.11 [=#point211 用户体验计划]=== {{{ 参考:http://trac.pc.com.cn/iphone/wiki/pcauto_pconline_4.0.0/intf#point228 }}} === 2.12 [=#point212 产品库产品分类重构]=== {{{ url: 电脑网:http://mrobot.pconline.com.cn/v3/itbbs/getUserInfo (可内测) 作用:同步论坛收藏的内容 使用范围:电脑网app、汽车网app 请求方式:get 是否需要登录:是 请求参数: common_session_id:用户登陆后获得的认证id 返回数据 { "nickname":"小小鸟" "name":"hahaha“, “common_session_id”:“afdsafjlasjfk;asdf”, "image":"www.baidu.com/sex.png", //头像 "level":"太平洋舰队新兵" //论坛等级 } }}}