Changes between Version 1 and Version 2 of pcauto_4.2.0/interface

Timestamp:

02/19/2014 05:03:19 PM (12 years ago)

Author:

maozhijun

Comment:

--

pcauto_4.2.0/interface

@@ -3 +3 @@
 == 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的最顶部，实现类似下面的代码：
-注意：需要用getQueryString()，不能用getParameter()
-String queryString = request.getQueryString();
-String reqEnc = getQueryValue(queryString,"req_enc=");
-if(reqEnc!=null){
-    request.setCharacterEncoding(reqEnc);
-}
-String respEnc = getQueryValue(queryString,"resp_enc=");
-if(respEnc!=null){
-    //out.println(respEnc);
-    response.setCharacterEncoding(respEnc);
-}
-String getQueryValue(String queryString,String key){
-    if(queryString==null || queryString.length()==0)return null;
-    int reqIdx = queryString.indexOf(key);//req_enc=utf-8&resp_enc=gbk
-    if(reqIdx!=-1){
-        reqIdx = reqIdx+key.length();
-        int endIdx = reqIdx;
-        for (; 
-        endIdx < queryString.length() && queryString.charAt(endIdx)!='&'; 
-        endIdx++) {
-        }
-        if(endIdx>reqIdx){
-            return queryString.substring(reqIdx,endIdx);
-        }
-    }
-    return null;
-}
-
-4.所有有写操作的数据接口，必须用POST方式提交，在接口里需要判断提交方式，拒绝GET的调用请求。
-
-5.接口中的JSON字符串，key都用双引号("")包裹，value是字符串类型时，也用双引号("")包裹；是数字类型时，不用引号。
-
-6.需要登录的接口，cache-control=600 ；分开优先级低和主动请求两种，前者用cacheFirst，后者用noCache
+接口默认的字符编码是UTF-8，接口需要实现对req_enc和resp_enc参数的支持
 
 接口URL: 接口URL
@@ -82 +39 @@
 
 必填参数:
-无
+二进制图片数据
 
 提交方式：POST
@@ -91 +48 @@
 返回结果： 成功：{retCode: 0} 失败：{retCode: xxx} 
 }}}
+
+=== 2.2 [=#point202 获取用户信息]===
+{{{
+
+接口URL:http://mrobot.pcauto.com.cn/v3/bbs/getUserInfo
+
+接口是否完善:否
+1.增加是否为验证车主标识
+2.增加验证车型
+
+}}}
+
+=== 2.3 [=#point203 验证码和发私信]===
+{{{
+验证码接口
+接口URL:http://captcha.pcauto.com.cn/captcha/v.jpg
+无参数
+返回一张验证码图片
+
+发私信接口
+接口URL:http://bip.pcauto.com.cn/intf/message.jsp?act=create
+必填参数：
+accountId:发送给某个用户
+content:消息内容
+captcha:验证码
+
+            /*
+             * 发送限制 add by handy 2012.04.01
+             * 1.post 2.验证码 3.黑名单
+             * 4.邮箱绑定,该限制仅限於2012-01-01起注册的用户 edit by handy 2012.04.10
+             * 5.发送频率 50次/ID/24H
+             * 6.白名单最多一次发送50个用户，非白名单则每次只能发一个 7.添加关键词库过滤
+             */
+
+结果返回
+{code:0,message:"提示"}
+}}}
+
+=== 2.4  [=#point204 我的论坛接口]===
+{{{
+接口URL:http://mrobot.pcauto.com.cn/v3/bbs/myTopics/13128876?pageNo=1&pageSize=20&maxLength=20
+接口是否已经完善:否
+1.参数增加删选类型,主贴|回帖|精华
+2,返回数据增加主|回帖标识,阅读数,主贴标题
+3,如果是回帖则增加回复内容,主贴作者ID和呢称
+}}}
+
+=== 2.5  [=#point205 我的收藏夹论坛列表]===
+{{{
+接口是否已经完善:否
+}}}
+
+=== 2.6  [=#point206 我的评论]===
+{{{
+接口是否已经完善:否
+}}}
+
+=== 2.7  [=#point207 我的好友列表]===
+{{{
+包括关注的好友和粉丝,用一个状态来标识
+
+接口是否已经完善:否
+}}}
+
+=== 2.8  [=#point208 收到的私信列表]===
+{{{
+接口URL:http://mrobot.pcauto.com.cn/v3/bbs/getMessageList?pageSize=20&pageNo=1
+接口是否已经完善:否
+}}}
+
+=== 2.9  [=#point209 发出的私信列表]===
+{{{
+接口URL:
+接口是否已经完善:否
+}}}
+
+=== 2.10  [=#point210 获取系统消息接口]===
+{{{
+接口URL:
+接口是否已经完善:否
+}}}
+
+=== 2.11  [=#point211 收集推送token接口]===
+{{{
+token数据放在passport2,赖子粼负责
+接口URL:
+接口是否已经完善:否
+}}}
+
+=== 2.12  [=#point212 获取他人信息接口]===
+{{{
+接口URL:
+接口是否已经完善:否
+}}}
+
+
+=== 2.13  [=#point213 获取他人最新动态接口]===
+{{{
+返回html页面
+接口URL:
+接口是否已经完善:否
+}}}
+
+=== 2.14  [=#point214 获取他人帖子列表]===
+{{{
+接口URL:
+接口是否已经完善:否
+}}}
+
+=== 2.15  [=#point215 获取他人评论列表]===
+{{{
+接口URL:
+接口是否已经完善:否
+}}}
+
+=== 2.16  [=#point216 获取他人爱车列表]===
+{{{
+接口URL:
+接口是否已经完善:否
+}}}
+
+=== 2.17  [=#point217 获取他人好友列表]===
+{{{
+接口URL:
+接口是否已经完善:否
+}}}
+
+=== 2.18  [=#point218 关注好友]===
+{{{
+接口URL:
+接口是否已经完善:否
+}}}
+
+=== 2.19  [=#point219 精准选车-车系列表接口]===
+{{{
+接口URL:
+接口是否已经完善:否
+}}}
+