Changes between Version 26 and Version 27 of web-intf

Timestamp:

12/30/2011 06:44:24 PM (14 years ago)

Author:

leijingtang

Comment:

--

web-intf

@@ -325 +325 @@
 }}}
 
+=== 2.9 /intf/home.jsp ===
+{{{
+    HTTP请求方式：get
+    是否需要登录：否
+    提交参数：req-enc：请求时字符编码，缺省是UTF-8  
+              resp-enc：响应时字符编码，缺省是UTF-8 
+    其他规则：该接口获取的是http://dp.pconline.com.cn摄影部落首页的4个分类中已经裁剪好的正方形图片；人像读取6张图片，另外3个分类各读取4张，一共18张。
+    返回参数：
+    {
+    "focus-img":[
+        {
+            "is-ad":0,
+            "small-img-src":"http://xxxx.jpg",
+            "album-name":"我是标题"
+        },
+        {
+            "is-ad":1,
+            "small-img-src":"http://xxxx.jpg",
+            "album-name":"我是标题"
+        }
+    ],
+    "types":["portrait", "landscape", "nature", "documentary"],
+    "portrait":[
+        {
+            "uid":2323,
+            "small-img-src":"http://img.pconline.com.cn/123.jpg",
+            "album-id":1233,
+            "theme":"拍摄主题",
+            "album-name":"图集名称",
+            "nickname":"摄影师昵称",
+            "is-picked":0,
+            "is-recommend":0,
+            "create-time":"yyyy-mm-dd hh:mi",
+            "vote":2233,
+            "clicks":2332
+        }
+    ],
+    "landscape":[
+        {
+            "uid":2323,
+            "small-img-src":"http://img.pconline.com.cn/123.jpg",
+            "album-id":1233,
+            "theme":"拍摄主题",
+            "album-name":"图集名称",
+            "nickname":"摄影师昵称",
+            "is-picked":0,
+            "is-recommend":0,
+            "create-time":"yyyy-mm-dd hh:mi",
+            "vote":2233,
+            "clicks":2332
+        }
+    ]
+}
+    focus-img：焦点图数组
+    is-ad：是否广告，1为是，0为否
+    types：目录名称列表，表明返回的数据里包含了该列表下目录的图集列表
+    portrait：目录名称，代表该目录的图集列表；与上面的types字段相关联，在types中出现的目录才会在这里。
+    page-no：请求的页码，第一次为1
+    page-size：每个页面的记录数
+    uid：用户id
+    small-img-src：封面图片URL
+    album-id：图集ID
+    theme：拍摄主题
+    album-name：图集名称
+    nickname：摄影师昵称
+    is-picked：1-精华作品，0-普调作品
+    create-time:创建时间
+    vote：所得票数
+    clicks：点击数
+}}}
+
+=== 2.10 /intf/hot-users.jsp === 
+{{{
+
+    HTTP请求方式：get
+    是否需要登录：否
+    提交参数：
+              page-no：单个作者的图集分页页码
+              page-size：单个作者的图集分页数量
+              req-enc：请求时字符编码，缺省是UTF-8  
+              resp-enc：响应时字符编码，缺省是UTF-8 
+    返回参数：
+    {"users":[{"page-size":5,
+               "page-no":1,
+               "total":1,
+               "uid":1212,
+               "logo":"http://upc.pconline.com.cn/1233",
+               "user-name":"用户名称",
+               "nickname":"昵称",
+               "user-title":"用户头衔",
+               "user-address":"地区",
+               "albums":[{"album-id":3232,
+                          "small-img-src":"http://dp.pconline.com.cn/3223.jpg",
+                          "is-recommend":0},
+                         {"album-id":2343,
+                          "small-img-src":"http://dp.pconline.com.cn/3344.jpg",
+                          "is-recommend":1
+                         }]
+             }] 
+    }
+
+    page-no：单个作者的图集分页页码
+    page-size：单个作者的图集分页数量
+    total：单个作者的图集页码总数
+    uid：用户ID
+    logo：用户头像URL
+    user-name：用户名
+    nickname：用户昵称
+    user-title：用户头衔
+    user-address：用户地区
+    album-id：图集ID
+    small-img-src：图集封面URL
+    is-recommend：1-推荐作品，0-普通作品
+
+    排序方式：
+              1、同一个用户下的图集，先出个人推荐区的（这里按网站上个人推荐区的顺序排），后出普通图集（按图集发表时间逆序）.
+
+    其他：个人推荐区的数据和该用户的图集，数据是重叠的。需要进行数据去处重复的处理。
+
+}}}
+
+
 
 == 3. Error Code ==
@@ -331 +453 @@
 
 == 4. 修改历史 ==
+2011-12-30
+    - 修改接口（{{{http://dp.pconline.com.cn/intf/ipad/albums-by-type.jsp}}}），在order-by中增加了按最新评论时间和按评论数量排序的值，修改默认排序为按最新评论；请求类别（包括全部）返回的数据里，前面4个都是版主推荐的作品。精华作品例外。
+    - 修改接口（{{{http://dp.pconline.com.cn/intf/ipad/albums-by-type.jsp}}}），在order-by中增加了按最新评论时间和按评论数量排序的值，修改默认排序为按最新评论。
+    - 增加接口（/intf/hot-users.jsp）
+    - 增加接口（/intf/home.jsp）
+
 2011-12-16
     - 修改接口2.4（{{{http://dp.pconline.com.cn/intf/ipad/user-albums.jsp}}}），使其符合框架ver1.0.4中，page-10的规则。取消is-picked输出结果，增加is-recommend参数。