=== 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/product/brandNameTopv36 (已上线) 作用:获取产品库分类描述 使用范围:电脑网app 请求方式:get 是否需要登录:否 请求参数:none 备注:参考http://mrobot.pconline.com.cn/v3/product/brandNameTopv36,把部分数据改成以下值 返回数据 { "手机": [ "三星", "HTC", "诺基亚" ], "相机": [ "佳能", "尼康", "索尼" ], "笔记本": [ "联想", "惠普", "华硕" ] "超极本": [ "联想", "华硕", "宏碁" ], "平板电脑": [ "iPad", "安卓平板", "WP平板" ] } }}}