Changes between Version 4 and Version 5 of web-intf


Ignore:
Timestamp:
02/13/2012 12:29:52 PM (14 years ago)
Author:
yangbo
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • web-intf

    v4 v5  
    3232 
    3333 5.3 [#point503 创建行程 ] 
    34  
    3534 5.4 [#point504 修改行程 ] 
    36  
    3735 5.5 [#point505 活动报名 ] 
    38  
    3936 5.6 [#point506 删除活动成员 ] 
    40  
    4137 5.7 [#point507 发表活动总结（记账） ] 
    42  
    4338 5.8 [#point508 修改活动总结（记账） ] 
    44  
    45  5.9 [#point509 上传活动图片 ] 
    46  
    47  5.10 [#point510 创建用户 ] 
    48  
    49  5.11 [#point511 修改用户资料 ] 
    50  
    51  5.12 [#point512 获取用户资料 ] 
    52  
    53  5.13 [#point513 车友会查询 ] 
    54  
    55  5.14 [#point514 维护我关注的车友会 ] 
    56  
    57  5.15 [#point515 获取地区列表 ] 
    58  
    59  5.16 [#point516 获取评论列表 ] 
    60  
    61  5.17 [#point517 发表评论 ] 
    62  
    63  5.18 [#point518 获取推荐活动列表 ] 
    64  
    65  5.19 [#point519 查询路书 ] 
    66  
    67  5.20 [#point520 热门推荐 ] 
    68  
    69  5.21 [#point521 同车友会推荐 ] 
    70  
    71  5.22 [#point522 同地区推荐 ] 
     39 5.9 [#point509 删除活动记账 ] 
     40 5.10 [#point510 上传活动图片 ] 
     41 
     42 5.11 [#point511 创建用户 ] 
     43 
     44 5.12 [#point512 修改用户资料 ] 
     45 
     46 5.13 [#point513 获取用户资料 ] 
     47 
     48 5.14 [#point514 车友会查询 ] 
     49 
     50 5.15 [#point515 维护我关注的车友会 ] 
     51 
     52 5.16 [#point516 获取地区列表 ] 
     53 
     54 5.17 [#point517 获取评论列表 ] 
     55 
     56 5.18 [#point518 发表评论 ] 
     57 
     58 5.19 [#point519 获取推荐活动列表 ] 
     59 
     60 5.20 [#point520 查询路书 ] 
     61 
     62 5.21 [#point521 热门推荐 ] 
     63 
     64 5.22 [#point522 同车友会推荐 ] 
     65 
     66 5.23 [#point523 同地区推荐 ] 
    7267 
    7368 6. [#point600 修改历史 ] 
    … …  
    123118== 5. [=#point500 车友会接口 ] == 
    124119=== 5.1 [=#point501 创建活动 ] === 
     120{{{ 
     121    URL：/intf/act-create.jsp 
     122    HTTP请求方式：post 
     123    是否需要登录：是 
     124    提交参数：common_session_id：登录后的session id 
     125              name：活动名称 
     126              start-date：开始时间 
     127              end-date：结束时间 
     128              pay：预计费用 
     129              count：人数限制 
     130              verify-str：验证密码 
     131              detail：活动详情 
     132              area-id：地区编号         
     133              req-enc：请求时字符编码，缺省是UTF-8 
     134              resp-enc：响应时字符编码，缺省是UTF-8 
     135    返回参数： 
     136    {"act-id":2342, 
     137     "name":"一起去海边", 
     138     "start-date":"2012-03-18", 
     139     "end-date":"2012-03-20", 
     140     "pay":800, 
     141     "count":20, 
     142     "verify-str":"下海去捞鱼", 
     143     "detail":"活动详情，里面通常包括了手台信息", 
     144     "area-id":233, 
     145     "area-desc":"广东省/广州市" 
     146    } 
     147    返回参数说明： 
     148        act-id：活动id 
     149        name：活动名称 
     150        start-date：开始日期（yyyy-mm-dd） 
     151        end-date：结束日期（yyyy-mm-dd） 
     152        pay：预计费用 
     153        count：人数限制 
     154        verify-str：验证密码 
     155        detail：活动详情 
     156        area-id：地区编号 
     157        area-desc：地区名称 
     158    排序方式： 
     159        无 
     160}}} 
     161 
    125162=== 5.2 [=#point502 获取活动（行程、成员） ] === 
     163{{{ 
     164    URL：/intf/act-get.jsp 
     165    HTTP请求方式：get 
     166    是否需要登录：否 
     167    提交参数：act-ids：活动id，用逗号分隔（122,332,344） 
     168              req-enc：请求时字符编码，缺省是UTF-8 
     169              resp-enc：响应时字符编码，缺省是UTF-8 
     170    返回参数： 
     171    {"acts":[{"act-id":122, 
     172              "name":"一起去海边", 
     173              "start-date":"2012-03-18", 
     174              "end-date":"2012-03-20", 
     175              "pay":800, 
     176              "count":20, 
     177              "verify-str":"下海去捞鱼", 
     178              "detail":"活动详情，里面通常包括了手台信息", 
     179              "area-id":233, 
     180              "area-desc":"广东省/广州市", 
     181              "created-by":"活动发起者", 
     182              "creater-nickname":"大浪淘沙", 
     183              "creater-mobile":"13932233232", 
     184              "act-routes":[{"route-id":12,"seq":1,"route-name":"广州","longitude":"23.2332.2332","latitude":"102.32.232"}, 
     185                           {"route-id":13,"seq":2,"route-name":"东莞","longitude":"23.2332.2332","latitude":"102.32.232"}, 
     186                           {"route-id":14,"seq":3,"route-name":"深圳","longitude":"23.2332.2332","latitude":"102.32.232"}], 
     187              "act-member":[{"member-id":12232,"uid":232332,"type":"manager","mobile":"18933300984","license-plate":"粤A-23456"}, 
     188                            {"member-id":12233,"uid":234343,"type":"member","mobile":"18933300984","license-plate":""}] 
     189             } 
     190            ] 
     191    } 
     192    返回参数说明： 
     193        act-id：活动编号 
     194        name：活动名称 
     195        start-date：开始日期 
     196        end-date：结束日期 
     197        pay：活动费用 
     198        count：人数限制 
     199        verify-str：活动密码 
     200        detail：活动详情 
     201        area-id：地区编号 
     202        area-desc：地区名称 
     203        created-by：活动创建者ID，这个ID是太平洋公共帐号ID。 
     204        creater-nickname：创建者昵称，从个人资料中获取，冗余在结果里。 
     205        creater-mobile：创建者手机，从个人资料中获取，冗余在结果里。 
     206        route-id：行程编号 
     207        seq：行程顺序号 
     208        route-name：停留点名称 
     209        longitude：经度 
     210        latitude：纬度 
     211        member-id：活动成员编号 
     212        uid：活动成员的太平洋公共帐号 
     213        type：活动成员身份 
     214        mobile：活动成员手机，默认从个人资料获取，网友可以在参加活动时修改 
     215        license-plate：活动成员车牌，默认从个人资料获取，网友可以在参加活动时修改 
     216    排序方式： 
     217        1、按传入的act-id顺序排序 
     218        2、按活动创建时间逆序 
     219}}} 
     220 
    126221=== 5.3 [=#point503 创建行程 ] === 
     222{{{ 
     223    URL：/intf/act-route-create.jsp 
     224    HTTP请求方式：post 
     225    是否需要登录：是 
     226    提交参数：common_session_id：登录后的session id 
     227              routes：[{"seq":1,"route-name":"广州","longitude":"23.2332.2332","latitude":"102.32.232"}, 
     228                       {"seq":2,"route-name":"东莞","longitude":"23.2332.2332","latitude":"102.32.232"}] 
     229              req-enc：请求时字符编码，缺省是UTF-8 
     230              resp-enc：响应时字符编码，缺省是UTF-8 
     231    返回参数： 
     232    {"act-rountes":[{"route-id":12,"seq":1,"route-name":"广州","longitude":"23.2332.2332","latitude":"102.32.232"}, 
     233                    {"route-id":13,"seq":2,"route-name":"东莞","longitude":"23.2332.2332","latitude":"102.32.232"}, 
     234                    {"route-id":14,"seq":3,"route-name":"深圳","longitude":"23.2332.2332","latitude":"102.32.232"}] 
     235    } 
     236    返回参数说明： 
     237        route-id：行程编号 
     238        seq：行程顺序号 
     239        route-name：停留点名称 
     240        longitude：经度 
     241        latitude：纬度         
     242    排序方式： 
     243        1、按照seq顺序排列 
     244}}} 
     245 
    127246=== 5.4 [=#point504 修改行程 ] === 
     247{{{ 
     248    URL：/intf/act-route-update.jsp， 采取删除/重建的方式来实现修改操作。 
     249    HTTP请求方式：post 
     250    是否需要登录：否 
     251    提交参数：common_session_id：登录后的session id 
     252              routes：[{"seq":1,"route-name":"广州","longitude":"23.2332.2332","latitude":"102.32.232"}, 
     253                       {"seq":2,"route-name":"东莞","longitude":"23.2332.2332","latitude":"102.32.232"}] 
     254              req-enc：请求时字符编码，缺省是UTF-8 
     255              resp-enc：响应时字符编码，缺省是UTF-8 
     256    返回参数： 
     257    {"act-rountes":[{"route-id":12,"seq":1,"route-name":"广州","longitude":"23.2332.2332","latitude":"102.32.232"}, 
     258                    {"route-id":13,"seq":2,"route-name":"东莞","longitude":"23.2332.2332","latitude":"102.32.232"}, 
     259                    {"route-id":14,"seq":3,"route-name":"深圳","longitude":"23.2332.2332","latitude":"102.32.232"}] 
     260    } 
     261    返回参数说明： 
     262        route-id：行程编号 
     263        seq：行程顺序号 
     264        route-name：停留点名称 
     265        longitude：经度 
     266        latitude：纬度         
     267    排序方式： 
     268        1、按照seq顺序排列 
     269 
     270}}} 
     271 
    128272=== 5.5 [=#point505 活动报名 ] === 
     273{{{ 
     274    URL：/intf/act-apply.jsp，报名成功后返回活动信息，方便应用处理。 
     275    HTTP请求方式：post 
     276    是否需要登录：是 
     277    提交参数：common_session_id：登录后的session id 
     278              act-id：活动ID 
     279              verify-str：验证密码 
     280              license-plate：车牌 
     281              mobile：手机 
     282              req-enc：请求时字符编码，缺省是UTF-8 
     283              resp-enc：响应时字符编码，缺省是UTF-8 
     284    返回参数： 
     285    {"acts":[{"act-id":122, 
     286              "name":"一起去海边", 
     287              "start-date":"2012-03-18", 
     288              "end-date":"2012-03-20", 
     289              "pay":800, 
     290              "count":20, 
     291              "verify-str":"下海去捞鱼", 
     292              "detail":"活动详情，里面通常包括了手台信息", 
     293              "area-id":233, 
     294              "area-desc":"广东省/广州市", 
     295              "created-by":"活动发起者", 
     296              "creater-nickname":"大浪淘沙", 
     297              "creater-mobile":"13932233232", 
     298              "act-routes":[{"route-id":12,"seq":1,"route-name":"广州","longitude":"23.2332.2332","latitude":"102.32.232"}, 
     299                           {"route-id":13,"seq":2,"route-name":"东莞","longitude":"23.2332.2332","latitude":"102.32.232"}, 
     300                           {"route-id":14,"seq":3,"route-name":"深圳","longitude":"23.2332.2332","latitude":"102.32.232"}], 
     301              "act-member":[{"member-id":12232,"uid":232332,"type":"manager","mobile":"18933300984","license-plate":"粤A-23456"}, 
     302                            {"member-id":12233,"uid":234343,"type":"member","mobile":"18933300984","license-plate":""}] 
     303             } 
     304            ] 
     305       } 
     306    返回参数说明： 
     307        act-id：活动编号 
     308        name：活动名称 
     309        start-date：开始日期 
     310        end-date：结束日期 
     311        pay：活动费用 
     312        count：人数限制 
     313        verify-str：活动密码 
     314        detail：活动详情 
     315        area-id：地区编号 
     316        area-desc：地区名称 
     317        created-by：活动创建者ID，这个ID是太平洋公共帐号ID。 
     318        creater-nickname：创建者昵称，从个人资料中获取，冗余在结果里。 
     319        creater-mobile：创建者手机，从个人资料中获取，冗余在结果里。 
     320        route-id：行程编号 
     321        seq：行程顺序号 
     322        route-name：停留点名称 
     323        longitude：经度 
     324        latitude：纬度 
     325        member-id：活动成员编号 
     326        uid：活动成员的太平洋公共帐号 
     327        type：活动成员身份 
     328        mobile：活动成员手机，默认从个人资料获取，网友可以在参加活动时修改 
     329        license-plate：活动成员车牌，默认从个人资料获取，网友可以在参加活动时修改 
     330    排序方式： 
     331        无。 
     332 
     333}}} 
     334 
     335 
    129336=== 5.6 [=#point506 删除活动成员 ] === 
     337{{{ 
     338    URL：/intf/act-member-del.jsp 
     339    HTTP请求方式：post 
     340    是否需要登录：是 
     341    提交参数：common_session_id：登录后的session id 
     342              uids：活动成员id，可以是一个或多个id，多个id之间用逗号（','）分隔，例如（2123,23434,434,343） 
     343              req-enc：请求时字符编码，缺省是UTF-8 
     344              resp-enc：响应时字符编码，缺省是UTF-8 
     345    返回参数： 
     346        无。 
     347    排序方式： 
     348        无。 
     349 
     350}}} 
     351 
     352 
    130353=== 5.7 [=#point507 发表活动总结（记账） ] === 
     354{{{ 
     355    URL：/intf/act-pay-create.jsp 
     356    HTTP请求方式：post 
     357    是否需要登录：是 
     358    提交参数：common_session_id：登录后的session id 
     359              pay-type：记账类型 
     360              pay：金额 
     361              desc：描述 
     362              req-enc：请求时字符编码，缺省是UTF-8 
     363              resp-enc：响应时字符编码，缺省是UTF-8 
     364    返回参数： 
     365        {"id":233,"pay-type":"住宿","pay":4340,"desc":"住宿费用"} 
     366    返回参数说明： 
     367        id：费用记录ID 
     368        pay-type：费用类型 
     369        pay：费用 
     370        desc：费用描述 
     371    排序方式： 
     372        无。 
     373 
     374}}} 
     375 
    131376=== 5.8 [=#point508 修改活动总结（记账） ] === 
    132 === 5.9 [=#point509 上传活动图片 ] === 
    133 === 5.10 [=#point510 创建用户 ] === 
    134 === 5.11 [=#point511 修改用户资料 ] === 
    135 === 5.12 [=#point512 获取用户资料 ] === 
    136 === 5.13 [=#point513 车友会查询 ] === 
    137 === 5.14 [=#point514 维护我关注的车友会 ] === 
    138 === 5.15 [=#point515 获取地区列表 ] === 
    139 === 5.16 [=#point516 获取评论列表 ] === 
    140 === 5.17 [=#point517 发表评论 ] === 
    141 === 5.18 [=#point518 获取推荐活动列表 ] === 
    142 === 5.19 [=#point519 查询路书 ] === 
    143 === 5.20 [=#point520 热门推荐 ] === 
    144 === 5.21 [=#point521 同车友会推荐 ] === 
    145 === 5.22 [=#point522 同地区推荐 ] === 
     377{{{ 
     378    URL：/intf/act-pay-update.jsp 
     379    HTTP请求方式：post 
     380    是否需要登录：是 
     381    提交参数：common_session_id：登录后的session id 
     382              id：记账id 
     383              pay-type：记账类型 
     384              pay：金额 
     385              desc：描述 
     386              req-enc：请求时字符编码，缺省是UTF-8 
     387              resp-enc：响应时字符编码，缺省是UTF-8 
     388    返回参数： 
     389        {"id":233,"pay-type":"住宿","pay":4340,"desc":"住宿费用"} 
     390    返回参数说明： 
     391        id：费用记录ID 
     392        pay-type：费用类型 
     393        pay：费用 
     394        desc：费用描述 
     395    排序方式： 
     396        无。 
     397 
     398}}} 
     399 
     400=== 5.9 [=#point509 删除活动记账 ] === 
     401{{{ 
     402    URL：/intf/act-pay-del.jsp 
     403    HTTP请求方式：post 
     404    是否需要登录：是 
     405    提交参数：common_session_id：登录后的session id 
     406              ids：记账id的集合，用逗号分隔不同的id，例如（233,323,323,323） 
     407              req-enc：请求时字符编码，缺省是UTF-8 
     408              resp-enc：响应时字符编码，缺省是UTF-8 
     409    返回参数： 
     410        无。 
     411    排序方式： 
     412        无。 
     413 
     414}}} 
     415 
     416=== 5.10 [=#point510 上传活动图片 ] === 
     417=== 5.11 [=#point511 创建用户 ] === 
     418=== 5.12 [=#point512 修改用户资料 ] === 
     419=== 5.13 [=#point513 获取用户资料 ] === 
     420=== 5.14 [=#point514 车友会查询 ] === 
     421=== 5.15 [=#point515 维护我关注的车友会 ] === 
     422=== 5.16 [=#point516 获取地区列表 ] === 
     423=== 5.17 [=#point517 获取评论列表 ] === 
     424=== 5.18 [=#point518 发表评论 ] === 
     425=== 5.19 [=#point519 获取推荐活动列表 ] === 
     426=== 5.20 [=#point520 查询路书 ] === 
     427=== 5.21 [=#point521 热门推荐 ] === 
     428=== 5.22 [=#point522 同车友会推荐 ] === 
     429=== 5.23 [=#point523 同地区推荐 ] === 
    146430 
    147431== 5. [=#point500 车友会接口 ] ==