Changes between Version 10 and Version 11 of price_jiekou

Timestamp:

07/19/2013 12:13:16 PM (13 years ago)

Author:

chenyu

Comment:

--

price_jiekou

@@ -1 @@
-优惠首页
-
-发现
-
-我的
-
-优惠详情
-
-发现详情
-
-文章评论
-
-=== 1.1 优惠/发现 分类接口 ===
+== 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 优惠/发现 分类接口 ===
 {{{
 HTTP请求方式：get
@@ -47 +67 @@
 }}}
 
-=== 1.2文章列表接口 ===
+=== 2.2文章列表接口 ===
 {{{
     请求参数: 分类
@@ -72 +92 @@
 }}}
 
-=== 1.3 终端页接口 ===
+=== 2.3 终端页接口 ===
 {{{
 请求方法：get
@@ -81 +101 @@
 }}}
 
-=== 1.4 评论列表接口 ===
+=== 2.4 评论列表接口 ===
 {{{
  HTTP请求方式：get
@@ -159 +179 @@
 }}}
 
-1.5 发评论接口
+=== 2.5 发评论接口 ===
 {{{
 http://cmt.pcauto.com.cn/action/comment/create_utf8.jsp
@@ -181 +201 @@
 }}}
 
-=== 1.6 值不值接口 ===
+=== 2.6 值不值接口 ===
 {{{
     请求参数: 
@@ -198 +218 @@
 }}}
 
-=== 1.7 摇一摇接口 ===
+=== 2.7 摇一摇接口 ===
 {{{
     请求参数: 无
@@ -223 +243 @@
 }}}
 
-=== 1.8 发现列表接口 ===
+=== 2.8 发现列表接口 ===
 {{{
     请求参数: 分类