Changes between Initial Version and Version 1 of web-intf

Timestamp:

12/06/2011 02:54:37 PM (14 years ago)

Author:

yangbo

Comment:

--

web-intf

@@ +1 @@
+ == 摄影部落IPAD版接口列表 ==
+
+=== 1. /intf/albums-by-type.jsp  获取分类相册 ===
+{{{
+    HTTP请求方式：get                         
+    是否需要登录：否                          
+    请求参数：page-no：请求的页码，第一次为1。
+              page-size：每个页面的记录数。   
+              album-type：相册类型（最新精华：pick,人像：portrait,风光：landscape,生态：nature,纪实：documentary,其他：other） 
+              req-enc：请求时字符编码，缺省是UTF-8  
+              resp-enc：响应时字符编码，缺省是UTF-8 
+
+    返回参数： 
+    {"albums":[{"uid":2323,
+                "small-img-src":"{{{http://img.pconline.com.cn/123.jpg}}}",
+                "album-id":1233,
+                "theme":"拍摄主题",
+                "album-name":"图集名称",
+                "nickname":"摄影师昵称",
+                "vote":2233,
+                "clicks":2332
+                }]
+    }
+    page-no：请求的页码，第一次为1。
+    page-size：每个页面的记录数。
+    img-src：封面图片URL
+    uid：用户id
+    album-id：图集ID
+    theme：拍摄主题
+    album-name：图集名称
+    nickname：摄影师昵称
+    vote：所得票数
+    clicks：点击数
+
+    排序方式：图集更新时间逆序
+}}}
+
+
+=== 2. /intf/search.jsp ===
+{{{
+    HTTP请求方式：get
+    是否需要登录：否
+    请求参数：kw：查询关键字
+              req-enc：请求时字符编码，缺省是UTF-8
+              resp-enc：响应时字符编码，缺省是UTF-8
+              page-no：请求的页码，第一次为1。
+              page-size：每个页面的记录数。
+    返回参数：
+    {"page-no":1,
+     "page-size":10,
+     "total":100,
+     "kw":"蓝天白云",
+     "result":[{"uid":23234,
+                "small-img-src":"http://img.pconline.com.cn/123.jpg",
+                "album-id":1233,
+                "theme":"拍摄主题",
+                "album-name":"图集名称",
+                "nickname":"摄影师昵称",
+                "vote":232323,
+                "clicks":2323
+                }]
+    }
+    page-no：
+    page-size：
+    kw：搜索关键字
+    uid：用户id
+    small-img-src：封面图片URL
+    album-id：图集ID
+    theme：拍摄主题
+    album-name：图集名称
+    nickname：摄影师昵称
+    vote：所得票数
+    clicks：点击数
+
+
+    排序方式：XXXX
+}}}
+
+=== 3. /intf/user-photos.jsp ===
+
+{{{
+    HTTP请求方式：get
+    是否需要登录：否
+    请求参数：uid：用户id
+              req-enc：请求时字符编码，缺省是UTF-8
+              resp-enc：响应时字符编码，缺省是UTF-8
+              page-no：请求的页码，第一次为1。
+              page-size：每个页面的记录数。
+    返回参数：    
+    {"page-no":1,
+     "page-size":10,
+     "total":100,
+     "uid":2342,
+     "logo":"http://upc.pconline.com.cn/23323.jpg",
+     "nickname":"摄影师昵称",
+     "album-id":1233,
+     "theme":"拍摄主题",
+     "address":"拍摄地点",
+     "timer":"拍摄时间(yyyy-mm-dd)",
+     "type":"作品性质",
+     "vote":233,
+     "clicks":23223,
+     "abstruct":"作品概括",
+     "photos":[{"photo-id":23234,
+                "small-img-src":"http://img.pconline.com.cn/123.jpg",
+                "big-img-src":"http://img.pconline.com.cn/123.jpg",
+                "exposure":"曝光方式",
+                "aperture":"光圈",
+                "shutter":"快门",
+                "iso":"iso值",
+                "ev":"曝光补偿",
+                "camera":"相机"}
+              ]
+    }
+
+    page-no：
+    page-size：
+    total：
+    uid：用户id
+    logo：用户头像
+    nickname：用户昵称
+    album-id：图集ID
+    theme：拍摄主题
+    address：拍摄地点
+    timer：拍摄时间
+    type：作品性质
+    vote：所得票数
+    clicks：点击数
+    abstruct：作品概括
+    photo-id：图片ID
+    small-img-src：封面图片URL
+    big-img-src：大图URL
+    exposure：曝光方式
+    aperture：光圈
+    shutter：快门
+    iso：iso值
+    ev：曝光补偿
+    camera：相机
+
+    排序方式：
+    XXXX
+}}}
+
+=== 4./intf/user-albums.jsp ===
+{{{
+    HTTP请求方式：get
+    是否需要登录：否
+    提交参数：uids：被关注的用户id集合，id之间用逗号分隔。例如(233,233232,434334,554,556534)
+              page-no：单个作者的图集分页页码
+              page-size：单个作者的图集分页数量
+    返回参数：
+    {"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",
+                          "picked":0},
+                         {"album-id":2343,
+                          "small-img-src":"http://dp.pconline.com.cn/3344.jpg",
+                          "picked":1
+                         }]
+             }] 
+    }
+
+    page-no：单个作者的图集分页页码
+    page-size：单个作者的图集分页数量
+    total：单个作者的图集页码总数
+    uid：用户ID
+    logo：用户头像URL
+    user-name：用户名
+    nickname：用户昵称
+    user-title：用户头衔
+    user-address：用户地区
+    album-id：图集ID
+    small-img-src：图集封面URL
+    picked：精华作品（0：非精华，1：精华）
+
+    错误列表：
+    1.提交的关注用户过多，请分批提交。
+}}}
+
+
+=== 5. /intf/comment-post.jsp ===
+{{{
+    HTTP请求方式：post
+    是否需要登录：否
+    提交参数：album-id：图集id
+              req-enc：请求时字符编码，缺省是UTF-8
+              resp-enc：响应时字符编码，缺省是UTF-8
+              common_session_id：登录后的session id（非必填参数）
+              comment：评论内容
+    返回参数：
+    {"album-id":223,"comment-id":12233,"comment":"评论内容","timer":"评论时间"}
+    album-id：图集id。
+    comment-id：评论ID。
+    comment：评论正文。
+    timer：评论时间。（yyyy-mm-dd hh:mi）
+}}}
+
+=== 6. /intf/comment-list.jsp ===
+{{{
+    HTTP请求方式：get
+    是否需要登录：否
+    提交参数：album-id：图集id
+              req-enc：请求时字符编码，缺省是UTF-8
+              resp-enc：响应时字符编码，缺省是UTF-8
+              comment：评论内容
+    返回参数：
+    {"page-no":1,
+     "page-size":10,
+     "total":100,
+     "album-id":2323,
+     "comments":[{"comment-id":1233,
+                  "comment":"评论正文",
+                  "timer":"评论时间"},
+                 {"comment-id":1233,
+                  "comment":"评论正文",
+                  "timer":"评论时间"}
+                 ]
+    }
+    page-no
+    page-size
+    total
+    album-id
+    comment-id
+    comment
+    timer    
+    排序方式：按timer倒序
+}}}
+
+=== 7. /intf/vote.jsp ===
+{{{
+    HTTP请求方式：post
+    是否需要登录：否
+    提交参数：album-id：图集id
+              device-id：设备ID
+    其他规则：一个设备，一天内，只能对单个作品，投票一次
+    返回参数：
+    {"album-id":2323,"vote":2323}
+    album-id：图集ID
+    vote：投票数
+}}}