wiki:web-intf

Version 1 (modified by yangbo, 14 years ago) (diff)

--

摄影部落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:投票数