Changes between Version 16 and Version 17 of web-intf


Ignore:
Timestamp:
02/22/2012 06:32:13 PM (14 years ago)
Author:
yangbo
Comment:

--

Legend:

Unmodified
Added
Removed
Modified

  • web-intf

    v16 v17  
    1919 
    2020 3.3 [#point303 辨认登录状态接口 ] 
    21  
    2221 
    2322 4. [#point400 BBS接口 -- 暂不实现 ] 
    … …  
    263262}}} 
    264263 
     264=== 5.1 [=#point501 创建活动 ] === 
     265{{{ 
     266    URL：/intf/act-create.jsp 
     267    HTTP请求方式：post 
     268    是否需要登录：是 
     269    提交参数：common_session_id：登录后的session id 
     270              name：活动名称 
     271              start-date：开始时间 
     272              end-date：结束时间 
     273              detail：活动详情 
     274              area-id：地区编号         
     275              req-enc：请求时字符编码，缺省是UTF-8 
     276              resp-enc：响应时字符编码，缺省是UTF-8 
     277    返回参数： 
     278    {"act-id":2342, 
     279     "name":"一起去海边", 
     280     "start-date":"2012-03-18", 
     281     "end-date":"2012-03-20", 
     282     "detail":"活动详情，里面通常包括了手台信息", 
     283     "area-id":233, 
     284     "area-desc":"广东省/广州市" 
     285    } 
     286    返回参数说明： 
     287        act-id：活动id 
     288        name：活动名称 
     289        start-date：开始日期（yyyy-mm-dd） 
     290        end-date：结束日期（yyyy-mm-dd） 
     291        detail：活动详情 
     292        area-id：地区编号 
     293        area-desc：地区名称 
     294    排序方式： 
     295        无 
     296}}} 
     297 
     298=== 5.2 [=#point502 修改活动 ] === 
     299{{{ 
     300    URL：/intf/act-update.jsp 
     301    HTTP请求方式：post 
     302    是否需要登录：是 
     303    提交参数：common_session_id：登录后的session id 
     304              act-id：活动id 
     305              name：活动名称 
     306              start-date：开始时间 
     307              end-date：结束时间 
     308              detail：活动详情 
     309              area-id：地区编号         
     310              req-enc：请求时字符编码，缺省是UTF-8 
     311              resp-enc：响应时字符编码，缺省是UTF-8 
     312    返回参数： 
     313    {"act-id":2342, 
     314     "name":"一起去海边", 
     315     "start-date":"2012-03-18", 
     316     "end-date":"2012-03-20", 
     317     "detail":"活动详情，里面通常包括了手台信息", 
     318     "area-id":233, 
     319     "area-desc":"广东省/广州市" 
     320    } 
     321    返回参数说明： 
     322        act-id：活动id 
     323        name：活动名称 
     324        start-date：开始日期（yyyy-mm-dd） 
     325        end-date：结束日期（yyyy-mm-dd） 
     326        detail：活动详情 
     327        area-id：地区编号 
     328        area-desc：地区名称 
     329    排序方式： 
     330        无 
     331}}} 
     332 
     333 
     334=== 5.3 [=#point503 更新活动状态 ] === 
     335{{{ 
     336    URL：/intf/act-update-status.jsp 
     337    HTTP请求方式：post 
     338    是否需要登录：是 
     339    提交参数：common_session_id：登录后的session id 
     340              act-id：活动id 
     341              status：活动名称 
     342              req-enc：请求时字符编码，缺省是UTF-8 
     343              resp-enc：响应时字符编码，缺省是UTF-8 
     344    返回参数： 
     345    {"act-id":2342, 
     346     "uid":23233, 
     347     "status":"一起去海边" 
     348    } 
     349    返回参数说明： 
     350        act-id：活动id 
     351        uid：用户ID 
     352        status：活动状态：XXXXXXX ，start,runing,close,deleted 
     353    排序方式： 
     354        无 
     355}}} 
     356 
     357 
    265358=== 5.2 [=#point502 获取活动（行程、成员） ] === 
    266359{{{ 
    … …  
    331424    是否需要登录：是 
    332425    提交参数：common_session_id：登录后的session id 
     426              act-id：活动id 
    333427              routes：[{"seq":1,"route-name":"广州","longitude":"23.2332.2332","latitude":"102.32.232", 
    334428                     "addr":"广州市高普路","province":"广东","city":"广州","distict":"天河","type":"start","desc":""}, 
    … …  
    338432              resp-enc：响应时字符编码，缺省是UTF-8 
    339433    返回参数： 
    340     {"act-rountes":[{"route-id":12,"seq":1,"route-name":"广州","longitude":"23.2332.2332","latitude":"102.32.232", 
     434    { "act-id":122, 
     435      "act-rountes":[{"route-id":12,"seq":1,"route-name":"广州","longitude":"23.2332.2332","latitude":"102.32.232", 
    341436                     "addr":"广州市高普路","province":"广东","city":"广州","distict":"天河","type":"start","desc":""}, 
    342437                    {"route-id":13,"seq":2,"route-name":"东莞","longitude":"23.2332.2332","latitude":"102.32.232", 
    … …  
    346441    } 
    347442    返回参数说明： 
     443        act-id：活动id 
    348444        route-id：行程编号 
    349445        seq：行程顺序号 
    … …  
    367463    是否需要登录：否 
    368464    提交参数：common_session_id：登录后的session id 
     465              act-id：活动id 
    369466              routes：[{"seq":1,"route-name":"广州","longitude":"23.2332.2332","latitude":"102.32.232", 
    370467                     "addr":"广州市高普路","province":"广东","city":"广州","distict":"天河","type":"start","desc":""}, 
    … …  
    374471              resp-enc：响应时字符编码，缺省是UTF-8 
    375472    返回参数： 
    376     {"act-rountes":[{"route-id":12,"seq":1,"route-name":"广州","longitude":"23.2332.2332","latitude":"102.32.232", 
     473    { "act-id":23232, 
     474      "act-rountes":[{"route-id":12,"seq":1,"route-name":"广州","longitude":"23.2332.2332","latitude":"102.32.232", 
    377475                     "addr":"广州市高普路","province":"广东","city":"广州","distict":"天河","type":"start","desc":""}, 
    378476                    {"route-id":13,"seq":2,"route-name":"东莞","longitude":"23.2332.2332","latitude":"102.32.232", 
    … …  
    382480    } 
    383481    返回参数说明： 
     482        act-id：活动ID 
    384483        route-id：行程编号 
    385484        seq：行程顺序号 
    … …  
    733832 
    734833}}} 
     834 
     835=== 5.16 [=#point516 我参加的活动 ] === 
     836{{{ 
     837    URL：/intf/user-act-get.jsp 
     838    HTTP请求方式：post 
     839    是否需要登录：是 
     840    提交参数：common_session_id：登录后的session id 
     841              page-no：分页页码 
     842              page-size：分页数量               
     843              req-enc：请求时字符编码，缺省是UTF-8 
     844              resp-enc：响应时字符编码，缺省是UTF-8 
     845    返回参数： 
     846        { "page-no":1, 
     847          "page-size":20, 
     848          "total":4,          
     849          "uid":32233, 
     850          "acts":[{"act-id":2323,"name":"明天去看海","create-date":"yyyy-mm-dd hh:mi"}, 
     851                  {"act-id":232,"name":"上山去打渔","create-date":"yyyy-mm-dd hh:mi"}] 
     852        } 
     853    返回参数说明： 
     854        page-no：请求的页码，第一次为1。 
     855        page-size：每个页面的记录数。 
     856        total：这次查询的记录总数。 
     857        uid：用户ID 
     858        act-id：活动id 
     859        name：活动名称 
     860        create-date：创建时间 
     861    排序方式： 
     862        1、按创建时间逆序 
     863}}} 
     864 
     865 
     866 
    735867=== 5.16 [=#point516 车友会查询 ] === 
    736868{{{ 
    … …  
    740872    提交参数：autofan-name：车友会名称 
    741873              autofan-id：车友会编号 
    742               page-no：单个作者的图集分页页码 
    743               page-size：单个作者的图集分页数量               
     874              page-no：分页页码 
     875              page-size：分页数量               
    744876              prefix：车友会名称的前缀（a-z） 
    745877              order-by：id-asc or name-asc  
    … …  
    9861118== 5. [=#point500 车友会接口 ] == 
    9871119== 6. [=#point600 修改历史 ] == 
     1120 
     11212012-02-22: 
     1122    - 
     1123 
     11242012-02-20: 
     1125    -发布基本版本接口 
     1126         
     1127