Changes between Version 5 and Version 6 of web-intf


Ignore:
Timestamp:
02/13/2012 02:05:49 PM (14 years ago)
Author:
yangbo
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • web-intf

    v5 v6  
    3232 
    3333 5.3 [#point503 创建行程 ] 
     34 
    3435 5.4 [#point504 修改行程 ] 
     36 
    3537 5.5 [#point505 活动报名 ] 
     38 
    3639 5.6 [#point506 删除活动成员 ] 
     40 
    3741 5.7 [#point507 发表活动总结（记账） ] 
     42 
    3843 5.8 [#point508 修改活动总结（记账） ] 
     44 
    3945 5.9 [#point509 删除活动记账 ] 
     46 
    4047 5.10 [#point510 上传活动图片 ] 
    4148 
    … …  
    415422 
    416423=== 5.10 [=#point510 上传活动图片 ] === 
     424{{{ 
     425    URL：/intf/act-photo-create.jsp 
     426    HTTP请求方式：post 
     427    是否需要登录：是 
     428    提交参数：common_session_id：登录后的session id 
     429              act-id：活动ID 
     430              img-url：原图URL 
     431              img-url-middle：中图URL 
     432              img-url-small：小图URL 
     433              desc：图片描述 
     434              req-enc：请求时字符编码，缺省是UTF-8 
     435              resp-enc：响应时字符编码，缺省是UTF-8 
     436    返回参数： 
     437        {  "act-id":2323, 
     438           "img-id":434343, 
     439           "img-url":"http://img.pconline.com.cn/2332.jpg", 
     440           "img-url-middle":"http://img.pconline.com.cn/3233.jpg", 
     441           "img-url-small":"http://img.pconline.com.cn/3232.jpg", 
     442           "desc":"清晨宁静的海滩"} 
     443    返回参数说明： 
     444        act-id：活动ID 
     445        img-id：图片ID 
     446        img-url：图片URL 
     447        img-url-middle：中图URL 
     448        img-url-small：小图URL 
     449        desc：图片描述 
     450    排序方式： 
     451        无。 
     452 
     453}}} 
    417454=== 5.11 [=#point511 创建用户 ] === 
     455{{{ 
     456    URL：/intf/act-photo-update.jsp 
     457    HTTP请求方式：post 
     458    是否需要登录：是 
     459    提交参数：common_session_id：登录后的session id 
     460              photo-id：活动ID 
     461              desc：图片描述 
     462              req-enc：请求时字符编码，缺省是UTF-8 
     463              resp-enc：响应时字符编码，缺省是UTF-8 
     464    返回参数： 
     465        无。 
     466    排序方式： 
     467        无。 
     468 
     469}}} 
    418470=== 5.12 [=#point512 修改用户资料 ] === 
     471{{{ 
     472    URL：/intf/user-maintain.jsp，已经调用passport接口，创建了太平洋帐号后，再调用此接口来创建车友汇的用户。 
     473    HTTP请求方式：post 
     474    是否需要登录：是 
     475    提交参数：common_session_id：登录后的session id 
     476              uid：用户ID 
     477              nickname：用户昵称 
     478              face-url：用户头像 
     479              face-url-large：用户头像（大尺寸） 
     480              login-type：登录类型，（SINA,QZONE） 
     481              open-id：开放平台用户ID 
     482              mobile：手机 
     483              license-plate：车牌号 
     484              autoclubs：我关注的车友会，车友会ID，用逗号分隔(3323,3232,23,233) 
     485              area-id：地区编号 
     486              req-enc：请求时字符编码，缺省是UTF-8 
     487              resp-enc：响应时字符编码，缺省是UTF-8 
     488    返回参数： 
     489        {"uid":433443, 
     490         "nickname":"上九天揽月", 
     491         "face-url":"http://qlogo1.store.qq.com/qzone/7685620/7685620/50", 
     492         "face-url-large":"http://qlogo1.store.qq.com/qzone/7685620/7685620/100", 
     493         "login-type":"SINA", 
     494         "open-id":23322332, 
     495         "mobile":"13934443224", 
     496         "license-plate":"粤A-32332", 
     497         "autoclubs":[{"id":332,"name":"雷霆会","logo":"http://img.autohome.com.cn/3232.jpg","logo-large":"http://img.autohome.com.cn/332.jpg"}, 
     498                      {"id":2332,"name":"车神汇","logo":"http://img.autohome.com.cn/3232.jpg","logo-large":"http://img.autohome.com.cn/332.jpg"}, 
     499                      {"id":2332,"name":"改装会","logo":"http://img.autohome.com.cn/3232.jpg","logo-large":"http://img.autohome.com.cn/332.jpg"}], 
     500         "area-id":"10010", 
     501         "area-desc":"广州"} 
     502    返回参数说明： 
     503        uid：太平洋公共帐号ID 
     504        nickname：用户昵称 
     505        face-url：头像URL 
     506        face-url-large：头像URL，大尺寸 
     507        login-type：登录类型（SINA,QZONE） 
     508        open-id：开放平台用户ID 
     509        mobile：手机 
     510        license-plate：汽车牌照 
     511        id：车友会编号 
     512        name：车友会名称 
     513        logo-url：车友会LOGO 
     514        logo-url-large：车友会LOGO大图 
     515        area-id：地区编号 
     516        area-desc：地区名称 
     517    排序方式： 
     518      无。 
     519 
     520}}} 
    419521=== 5.13 [=#point513 获取用户资料 ] === 
     522{{{ 
     523    URL：/intf/user-get.jsp，当不是获取的本人资料时，车牌号码和手机号需要进行保密处理。 
     524    HTTP请求方式：get 
     525    是否需要登录：否 
     526    提交参数：common_session_id：登录后的session id 
     527              uid:：用户ID 
     528              req-enc：请求时字符编码，缺省是UTF-8 
     529              resp-enc：响应时字符编码，缺省是UTF-8 
     530    返回参数： 
     531        {"uid":433443, 
     532         "nickname":"上九天揽月", 
     533         "face-url":"http://qlogo1.store.qq.com/qzone/7685620/7685620/50", 
     534         "face-url-large":"http://qlogo1.store.qq.com/qzone/7685620/7685620/100", 
     535         "login-type":"SINA", 
     536         "open-id":23322332, 
     537         "mobile":"13934443224", 
     538         "license-plate":"粤A-32332", 
     539         "autoclubs":[{"id":332,"name":"雷霆会","logo-url":"http://img.autohome.com.cn/3232.jpg","logo-large":"http://img.autohome.com.cn/332.jpg"}, 
     540                      {"id":2332,"name":"车神汇","logo-url":"http://img.autohome.com.cn/3232.jpg","logo-large":"http://img.autohome.com.cn/332.jpg"}, 
     541                      {"id":2332,"name":"改装会","logo":"http://img.autohome.com.cn/3232.jpg","logo-large":"http://img.autohome.com.cn/332.jpg"}], 
     542         "area-id":"10010", 
     543         "area-desc":"广州"} 
     544    返回参数说明： 
     545        uid：太平洋公共帐号ID 
     546        nickname：用户昵称 
     547        face-url：头像URL 
     548        face-url-large：头像URL，大尺寸 
     549        login-type：登录类型（SINA,QZONE） 
     550        open-id：开放平台用户ID 
     551        mobile：手机 
     552        license-plate：汽车牌照 
     553        id：车友会编号 
     554        name：车友会名称 
     555        logo-url：车友会LOGO 
     556        logo-url-large：车友会LOGO大图 
     557        area-id：地区编号 
     558        area-desc：地区名称 
     559    排序方式： 
     560          无。 
     561 
     562 
     563}}} 
    420564=== 5.14 [=#point514 车友会查询 ] === 
     565{{{ 
     566    URL：/intf/autofan-search.jsp 
     567    HTTP请求方式：get 
     568    是否需要登录：否 
     569    提交参数：autofan-name：车友会名称 
     570              autofan-id：车友会编号 
     571              page-no：单个作者的图集分页页码 
     572              page-size：单个作者的图集分页数量               
     573              order-by：id-asc or name-asc 
     574              req-enc：请求时字符编码，缺省是UTF-8 
     575              resp-enc：响应时字符编码，缺省是UTF-8 
     576    返回参数： 
     577        { "page-no":1, 
     578          "page-size":20, 
     579          "total":4, 
     580          "autufans":[{"id":22332,"name":"雷霆汇","logo":"http://img.autohome.com.cn/3232.jpg","logo-large":"http://img.autohome.com.cn/332.jpg"}, 
     581                      {"id":32342,"name":"雷霆汇","logo":"http://img.autohome.com.cn/3232.jpg","logo-large":"http://img.autohome.com.cn/332.jpg"}] 
     582        } 
     583    返回参数说明： 
     584        page-no：请求的页码，第一次为1。 
     585        page-size：每个页面的记录数。 
     586        total：这次查询的记录总数。 
     587        id：车友会编号 
     588        name：车友会名称 
     589        logo-url：车友会LOGO 
     590        logo-url-large：车友会LOGO大图 
     591    排序方式： 
     592        1、按id顺序 
     593        2、按名称顺序 
     594 
     595}}} 
    421596=== 5.15 [=#point515 维护我关注的车友会 ] === 
     597{{{ 
     598    URL：/intf/autufan-follow-create.jsp 
     599    HTTP请求方式：post 
     600    是否需要登录：是 
     601    提交参数：common_session_id：登录后的session id 
     602              uid:：用户ID 
     603              autofan-club-ids：我关注的车友会ID集合，用逗号区分各个车友会的ID，例如（323232,233232,2332233） 
     604              req-enc：请求时字符编码，缺省是UTF-8 
     605              resp-enc：响应时字符编码，缺省是UTF-8 
     606    返回参数： 
     607        { "uid":2332, 
     608          "autufans":[{"id":22332,"name":"雷霆汇","logo":"http://img.autohome.com.cn/3232.jpg","logo-large":"http://img.autohome.com.cn/332.jpg"}, 
     609                      {"id":32342,"name":"雷霆汇","logo":"http://img.autohome.com.cn/3232.jpg","logo-large":"http://img.autohome.com.cn/332.jpg"}] 
     610        } 
     611    返回参数说明： 
     612        uid：太平洋公共帐号 
     613        id：车友会编号 
     614        name：车友会名称 
     615        logo-url：车友会LOGO 
     616        logo-url-large：车友会LOGO大图 
     617    排序方式： 
     618        按follow的时间顺序排列。 
     619 
     620 
     621}}} 
    422622=== 5.16 [=#point516 获取地区列表 ] === 
     623{{{ 
     624XXXXXX 
     625}}} 
    423626=== 5.17 [=#point517 获取评论列表 ] === 
     627{{{ 
     628    URL：/intf/act-comment-get.jsp 
     629    HTTP请求方式：get 
     630    是否需要登录：否 
     631    提交参数：photo-id：图片ID 
     632              page-no：分页页码 
     633              page-size：单页数量 
     634              order-by：create-date-asc , create-date-desc 
     635              req-enc：请求时字符编码，缺省是UTF-8 
     636              resp-enc：响应时字符编码，缺省是UTF-8 
     637    返回参数： 
     638        {  "page-no":1, 
     639           "page-size":20, 
     640           "total":5, 
     641           "comments":[{"id":233, 
     642                        "uid":2332, 
     643                        "nickname":"上九天揽月", 
     644                        "face-url":"http://qlogo1.store.qq.com/qzone/7685620/7685620/50", 
     645                        "face-url-large":"http://qlogo1.store.qq.com/qzone/7685620/7685620/100", 
     646                        "content":"绝美的风光", 
     647                        "create-date":"2012-04-06 12:43"}, 
     648                       {"id":2335, 
     649                        "uid":233232, 
     650                        "nickname":"下五洋捉鳖", 
     651                        "face-url":"http://qlogo1.store.qq.com/qzone/7685620/7685620/50", 
     652                        "face-url-large":"http://qlogo1.store.qq.com/qzone/7685620/7685620/100", 
     653                        "content":"清晨的海滩真是美不胜收", 
     654                        "create-date":"2012-04-06 12:43"} 
     655                       ] 
     656        } 
     657    返回参数说明： 
     658        page-no：请求的页码，第一次为1。 
     659        page-size：每个页面的记录数。 
     660        total：这次查询的记录总数。 
     661        id：评论编号 
     662        uid：太平洋公共帐号id 
     663        nickname：用户昵称 
     664        face-url：用户头像URL 
     665        face-url-large：用户头像URL大图 
     666        content：评论正文 
     667        create-date：评论时间，yyyy-mm-dd hh:mi 。XXXXXX 这里要看评论列表上的时间是怎样显示的。 
     668    排序方式： 
     669        1、按评论创建时间顺序 
     670        2、按评论创建时间逆序 
     671 
     672}}} 
     673 
    424674=== 5.18 [=#point518 发表评论 ] === 
     675{{{ 
     676    URL：/intf/act-comment-create.jsp 
     677    HTTP请求方式：post 
     678    是否需要登录：是 
     679    提交参数：common_session_id：登录后的session id 
     680              photo-id：图片ID 
     681              uid：用户ID 
     682              content：评论正文 
     683              req-enc：请求时字符编码，缺省是UTF-8 
     684              resp-enc：响应时字符编码，缺省是UTF-8 
     685    返回参数： 
     686        {"id":233, 
     687         "uid":2332, 
     688         "nickname":"上九天揽月", 
     689         "face-url":"http://qlogo1.store.qq.com/qzone/7685620/7685620/50", 
     690         "face-url-large":"http://qlogo1.store.qq.com/qzone/7685620/7685620/100", 
     691         "content":"绝美的风光", 
     692         "create-date":"2012-04-06 12:43"} 
     693    返回参数说明： 
     694        id：评论编号 
     695        uid：太平洋公共帐号id 
     696        nickname：用户昵称 
     697        face-url：用户头像URL 
     698        face-url-large：用户头像URL大图 
     699        content：评论正文 
     700        create-date：评论时间，yyyy-mm-dd hh:mi 。XXXXXX 这里要看评论列表上的时间是怎样显示的。 
     701    排序方式： 
     702        无。 
     703 
     704 
     705}}} 
    425706=== 5.19 [=#point519 获取推荐活动列表 ] === 
     707{{{ 
     708    URL：/intf/act-recommend.jsp 
     709    HTTP请求方式：get 
     710    是否需要登录：否 
     711    提交参数：page-no：分页页码 
     712              page-size：单页数量 
     713              req-enc：请求时字符编码，缺省是UTF-8 
     714              resp-enc：响应时字符编码，缺省是UTF-8 
     715    返回参数： 
     716        { "page-no":1, 
     717          "page-size":20, 
     718          "total":2, 
     719          "acts":[{"id":32323, 
     720                    "name":"自驾去西藏", 
     721                    "status":1, 
     722                    "act-img":[{"img-id":121, 
     723                                "img-url":"http://img.pconline.com.cn/2332.jpg", 
     724                                "img-url-middle":"http://img.pconline.com.cn/3232.jpg", 
     725                                "img-url-small":"http://img.pconline.com.cn/32234.jpg", 
     726                                "desc":"宁静的海滩"}, 
     727                                {"img-id":121, 
     728                                "img-url":"http://img.pconline.com.cn/2332.jpg", 
     729                                "img-url-middle":"http://img.pconline.com.cn/3232.jpg", 
     730                                "img-url-small":"http://img.pconline.com.cn/32234.jpg", 
     731                                "desc":"宁静的海滩"} 
     732                              ] 
     733                   }, 
     734                   {"id":3253, 
     735                    "name":"海南自驾行", 
     736                    "status":0, 
     737                    "act-img":[{"img-id":121, 
     738                                "img-url":"http://img.pconline.com.cn/2332.jpg", 
     739                                "img-url-middle":"http://img.pconline.com.cn/3232.jpg", 
     740                                "img-url-small":"http://img.pconline.com.cn/32234.jpg", 
     741                                "desc":"宁静的海滩"}, 
     742                                {"img-id":121, 
     743                                "img-url":"http://img.pconline.com.cn/2332.jpg", 
     744                                "img-url-middle":"http://img.pconline.com.cn/3232.jpg", 
     745                                "img-url-small":"http://img.pconline.com.cn/32234.jpg", 
     746                                "desc":"宁静的海滩"} 
     747                              ] 
     748                   } 
     749                 ] 
     750        } 
     751    返回参数说明： 
     752        page-no：请求的页码，第一次为1。 
     753        page-size：每个页面的记录数。 
     754        total：这次查询的记录总数。 
     755        id：活动ID 
     756        name：活动名称 
     757        status：活动状态 
     758        img-id：图片ID 
     759        img-url：图片URL 
     760        img-url-middle：中图URL 
     761        img-url-small：小图URL 
     762        desc：图片描述 
     763    排序方式： 
     764        1、XXXX 
     765 
     766}}} 
    426767=== 5.20 [=#point520 查询路书 ] === 
     768{{{ 
     769    URL：/intf/act-search.jsp 
     770    HTTP请求方式：get 
     771    是否需要登录：否 
     772    提交参数：kw： 
     773              page-no：分页页码 
     774              page-size：单页数量 
     775              order-by：XXXXXXXX 
     776              req-enc：请求时字符编码，缺省是UTF-8 
     777              resp-enc：响应时字符编码，缺省是UTF-8 
     778    返回参数： 
     779        { "page-no":1, 
     780          "page-size":20, 
     781          "total":2, 
     782          "kw":"看海", 
     783          "acts":[{"id":32323, 
     784                    "name":"自驾去西藏", 
     785                    "status":1}, 
     786                   {"id":3253, 
     787                    "name":"海南自驾行", 
     788                    "status":0} 
     789                 ] 
     790        } 
     791    返回参数说明： 
     792        page-no：请求的页码，第一次为1。 
     793        page-size：每个页面的记录数。 
     794        total：这次查询的记录总数。 
     795        kw：搜索关键词 
     796        id：活动ID 
     797        name：活动名称 
     798        status：活动状态 
     799    排序方式： 
     800        1、按活动id逆序 
     801        2、XXXXXXX 
     802 
     803}}} 
    427804=== 5.21 [=#point521 热门推荐 ] === 
    428805=== 5.22 [=#point522 同车友会推荐 ] ===