Changes between Version 58 and Version 59 of appapi/4.0


Ignore:
Timestamp:
02/16/2015 05:19:47 PM (11 years ago)
Author:
zhouruxuan
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • appapi/4.0

    v58 v59  
    145145=== 1.2 照片相关 
    146146 
    147 ==== 1.2.1 根据车友会ID,返回相册列表 ==== 
     147==== 1.2.1 创建/修改相册 ==== 
     148{{{ 
     149接口/appapi/1.0/album/editAlbum.do [POST] 
     150说明 : 创建/修改相册 
     151请求参数: 
     152   albumId:相册ID 
     153   *albumName : 相册名字 
     154 
     155   备注:根据登录信息获取车友会信息 
     156         albumId > 0时,为修改相册,否则为创建相册 
     157 
     158是否登录 : 是 
     159缓存时间 : 无 
     160是否分页 : 否 
     161 
     162 
     163返回结果: 
     164{ 
     165   code : 0成功,-1失败 
     166   message : 提示信息 
     167   version : 接口版本号如1.0,1.0(latest)表示最新版本 
     168} 
     169}}} 
     170 
     171 
     172==== 1.2.2 上传图片 ==== 
     173{{{ 
     174接口/appapi/1.0/album/uploadPhotos.do [POST] 
     175说明 : 上传图片 
     176请求参数: 
     177  *albumId:相册ID 
     178  *photoList : [ 
     179          { 
     180            name : 图片名字 
     181            url : 图片URL        
     182           }, 
     183           { 
     184            name : 图片名字 
     185            url : 图片URL        
     186           } 
     187   ] 
     188 
     189 
     190是否登录 : 是 
     191缓存时间 : 无 
     192是否分页 : 否 
     193 
     194 
     195返回结果: 
     196{ 
     197   code : 0成功,-1失败 
     198   message : 提示信息 
     199   version : 接口版本号如1.0,1.0(latest)表示最新版本 
     200} 
     201}}} 
     202 
     203 
     204==== 1.2.3 设置封面 ==== 
     205{{{ 
     206接口/appapi/1.0/album/setAlbumCover.do [POST] 
     207说明 :  设置封面 
     208请求参数: 
     209     
     210   *albumId: 相册ID 
     211   *newCoverUrl: 新封面URL 
     212    
     213   备注:根据登录信息获取车友会信息 
     214 
     215 
     216是否登录 : 是 
     217缓存时间 : 无 
     218是否分页 : 否 
     219 
     220 
     221返回结果: 
     222{ 
     223   code : 0成功,-1失败 
     224   message : 提示信息 
     225   version : 接口版本号如1.0,1.0(latest)表示最新版本 
     226} 
     227}}} 
     228 
     229==== 1.2.4 移动照片(批量) ==== 
     230{{{ 
     231接口/appapi/1.0/album/movePhotos.do [POST] 
     232说明 :  移动照片(批量) 
     233请求参数: 
     234     
     235   *albumIdMoveIn : 接收照片相册ID 
     236   *albumIdMoveOut : 被移出照片的相册ID 
     237   *photoIds: 被移动的照片ID,使用“,”连接在一起 
     238    
     239   备注:根据登录信息获取车友会信息 
     240 
     241 
     242是否登录 : 是 
     243缓存时间 : 无 
     244是否分页 : 否 
     245 
     246 
     247返回结果: 
     248{ 
     249   code : 0成功,-1失败 
     250   message : 提示信息 
     251   version : 接口版本号如1.0,1.0(latest)表示最新版本 
     252} 
     253}}} 
     254 
     255 
     256==== 1.2.5 删除照片(批量) ==== 
     257{{{ 
     258接口/appapi/1.0/album/delPhotos.do [POST] 
     259说明 :  删除照片(批量) 
     260请求参数: 
     261     
     262   *albumId: 相册ID 
     263   *photoIds : 用“,”把相册ID连接起来 
     264    
     265   备注:根据登录信息获取车友会信息 
     266         如果找不到相关的照片,当作删除成功 
     267 
     268 
     269是否登录 : 是 
     270缓存时间 : 无 
     271是否分页 : 否 
     272 
     273 
     274返回结果: 
     275{ 
     276   code : 0成功,-1失败 
     277   message : 提示信息 
     278   version : 接口版本号如1.0,1.0(latest)表示最新版本 
     279} 
     280}}} 
     281 
     282 
     283==== 1.2.6 删除相册 ==== 
     284{{{ 
     285接口/appapi/1.0/album/delAlbum.do [POST] 
     286说明 : 删除相册 
     287请求参数: 
     288     
     289   *albumId: 相册ID 
     290    
     291   备注:根据登录信息获取车友会信息 
     292 
     293 
     294是否登录 : 是 
     295缓存时间 : 无 
     296是否分页 : 否 
     297 
     298 
     299返回结果: 
     300{ 
     301   code : 0成功,-1失败 
     302   message : 提示信息 
     303   version : 接口版本号如1.0,1.0(latest)表示最新版本 
     304} 
     305}}} 
     306 
     307 
     308==== 1.2.7 根据相册ID返回相片列表 ==== 
     309{{{ 
     310接口/appapi/1.0/album/getPhotoByAlbumId.do [GET] 
     311说明 : 根据相册ID返回相片列表 
     312请求参数: 
     313  *albumId:相册ID 
     314  
     315 
     316是否登录 : 否 
     317缓存时间 : 无 
     318是否分页 : 否 
     319 
     320 
     321返回结果: 
     322{ 
     323 
     324   albumId : 相册ID 
     325   albumName : 相册名字 
     326   createAt : 相册创建时间 
     327   createBy : 相册创建者 
     328   nickName : 创建者昵称 
     329   authorPhoto : 创建者头像 
     330   isVip : 是否认证 
     331    
     332   photoList : [ 
     333          { 
     334            photoId : 照片ID 
     335            createBy : 上传者ID 
     336            urlSamll : 小图片 
     337            urlBig : 大图片          
     338           }, 
     339           { 
     340            photoId : 照片ID 
     341            createBy : 上传者ID 
     342            urlSamll : 小图片 
     343            urlBig : 大图片          
     344           } 
     345   ] 
     346 
     347   code : 0成功,-1失败 
     348   message : 提示信息 
     349   version : 接口版本号如1.0,1.0(latest)表示最新版本 
     350} 
     351}}} 
     352 
     353 
     354==== 1.2.8 根据用户ID获取车友会相册列表 ==== 
     355{{{ 
     356接口/appapi/1.0/album/getAlbumByUserId.do [GET] 
     357说明 : 根据用户ID获取车友会相册数据  
     358请求参数: 
     359 
     360   备注:根据登录信息获取车友会信息 
     361 
     362 
     363是否登录 : 是 
     364缓存时间 : 无 
     365是否分页 : 是 
     366 
     367 
     368返回结果: 
     369{ 
     370    userId : 用户ID 
     371    clubId : 车友会ID 
     372    albumList : [ 
     373       { 
     374         albumId : 相册ID 
     375         albumName : 相册名称 
     376         coverUrl : 封面图片URL 
     377         isDefault : 0,默认相册;1:不是默认相册 
     378        } 
     379 
     380    ] 
     381 
     382    total:总条数 
     383    pageNo:页码 
     384    pageSize:每页条数 
     385    pageCount:总共几页 
     386 
     387   code : 0成功,-1失败 
     388   message : 提示信息 
     389   version : 接口版本号如1.0,1.0(latest)表示最新版本 
     390} 
     391}}} 
     392 
     393 
     394==== 1.2.9 根据车友会ID获取相册列表 ==== 
    148395{{{ 
    149396接口/appapi/1.0/album/getAlbumByClubId.do [GET] 
    150 说明 : 根据车友会ID,返回相册列表 
     397说明 : 根据车友会ID获取相册列表 
    151398请求参数: 
    152399  *clubId :车友会ID 
     
    219466}}} 
    220467 
    221 ==== 1.2.2 根据相册ID返回相片列表 ==== 
    222 {{{ 
    223 接口/appapi/1.0/album/getPhotoByAlbumId.do [GET] 
    224 说明 : 根据相册ID返回相片列表 
    225 请求参数: 
    226   *albumId:相册ID 
    227   
    228  
    229 是否登录 : 否 
    230 缓存时间 : 无 
    231 是否分页 : 否 
    232  
    233  
    234 返回结果: 
    235 { 
    236  
    237    albumId : 相册ID 
    238    albumName : 相册名字 
    239    createAt : 相册创建时间 
    240    createBy : 相册创建者 
    241    nickName : 创建者昵称 
    242    authorPhoto : 创建者头像 
    243    isVip : 是否认证 
    244     
    245    photoList : [ 
    246           { 
    247             photoId : 照片ID 
    248             createBy : 上传者ID 
    249             urlSamll : 小图片 
    250             urlBig : 大图片          
    251            }, 
    252            { 
    253             photoId : 照片ID 
    254             createBy : 上传者ID 
    255             urlSamll : 小图片 
    256             urlBig : 大图片          
    257            } 
    258    ] 
    259  
    260    code : 0成功,-1失败 
    261    message : 提示信息 
    262    version : 接口版本号如1.0,1.0(latest)表示最新版本 
    263 } 
    264 }}} 
    265  
    266  
    267 ==== 1.2.3 上传图片 ==== 
    268 {{{ 
    269 接口/appapi/1.0/album/uploadPhotos.do [POST] 
    270 说明 : 上传图片 
    271 请求参数: 
    272   *albumId:相册ID 
    273   *photoList : [ 
    274           { 
    275             name : 图片名字 
    276             url : 图片URL        
    277            }, 
    278            { 
    279             name : 图片名字 
    280             url : 图片URL        
    281            } 
    282    ] 
    283  
    284  
    285 是否登录 : 是 
    286 缓存时间 : 无 
    287 是否分页 : 否 
    288  
    289  
    290 返回结果: 
    291 { 
    292    code : 0成功,-1失败 
    293    message : 提示信息 
    294    version : 接口版本号如1.0,1.0(latest)表示最新版本 
    295 } 
    296 }}} 
    297  
    298 ==== 1.2.4 创建/修改相册 ==== 
    299 {{{ 
    300 接口/appapi/1.0/album/editAlbum.do [POST] 
    301 说明 : 创建/修改相册 
    302 请求参数: 
    303    albumId:相册ID 
    304    *albumName : 相册名字 
    305  
    306    备注:根据登录信息获取车友会信息 
    307          albumId > 0时,为修改相册,否则为创建相册 
    308  
    309 是否登录 : 是 
    310 缓存时间 : 无 
    311 是否分页 : 否 
    312  
    313  
    314 返回结果: 
    315 { 
    316    code : 0成功,-1失败 
    317    message : 提示信息 
    318    version : 接口版本号如1.0,1.0(latest)表示最新版本 
    319 } 
    320 }}} 
    321  
    322 ==== 1.2.5 根据用户ID获取车友会相册列表 ==== 
    323 {{{ 
    324 接口/appapi/1.0/album/getAlbumByUserId.do [GET] 
    325 说明 : 根据用户ID获取车友会相册数据  
    326 请求参数: 
    327  
    328    备注:根据登录信息获取车友会信息 
    329  
    330  
    331 是否登录 : 是 
    332 缓存时间 : 无 
    333 是否分页 : 是 
    334  
    335  
    336 返回结果: 
    337 { 
    338     userId : 用户ID 
    339     clubId : 车友会ID 
    340     albumList : [ 
    341        { 
    342          albumId : 相册ID 
    343          albumName : 相册名称 
    344          coverUrl : 封面图片URL 
    345          isDefault : 0,默认相册;1:不是默认相册 
    346         } 
    347  
    348     ] 
    349  
    350     total:总条数 
    351     pageNo:页码 
    352     pageSize:每页条数 
    353     pageCount:总共几页 
    354  
    355    code : 0成功,-1失败 
    356    message : 提示信息 
    357    version : 接口版本号如1.0,1.0(latest)表示最新版本 
    358 } 
    359 }}} 
    360  
    361 ==== 1.2.6 删除相册 ==== 
    362 {{{ 
    363 接口/appapi/1.0/album/delAlbum.do [POST] 
    364 说明 : 删除相册 
    365 请求参数: 
    366      
    367    *albumId: 相册ID 
    368     
    369    备注:根据登录信息获取车友会信息 
    370  
    371  
    372 是否登录 : 是 
    373 缓存时间 : 无 
    374 是否分页 : 否 
    375  
    376  
    377 返回结果: 
    378 { 
    379    code : 0成功,-1失败 
    380    message : 提示信息 
    381    version : 接口版本号如1.0,1.0(latest)表示最新版本 
    382 } 
    383 }}} 
    384  
    385 ==== 1.2.7 删除照片(批量) ==== 
    386 {{{ 
    387 接口/appapi/1.0/album/delPhotos.do [POST] 
    388 说明 :  删除照片(批量) 
    389 请求参数: 
    390      
    391    *albumId: 相册ID 
    392    *photoIds : 用“,”把相册ID连接起来 
    393     
    394    备注:根据登录信息获取车友会信息 
    395          如果找不到相关的照片,当作删除成功 
    396  
    397  
    398 是否登录 : 是 
    399 缓存时间 : 无 
    400 是否分页 : 否 
    401  
    402  
    403 返回结果: 
    404 { 
    405    code : 0成功,-1失败 
    406    message : 提示信息 
    407    version : 接口版本号如1.0,1.0(latest)表示最新版本 
    408 } 
    409 }}} 
    410  
    411 ==== 1.2.8 设置封面 ==== 
    412 {{{ 
    413 接口/appapi/1.0/album/setAlbumCover.do [POST] 
    414 说明 :  设置封面 
    415 请求参数: 
    416      
    417    *albumId: 相册ID 
    418    *newCoverUrl: 新封面URL 
    419     
    420    备注:根据登录信息获取车友会信息 
    421  
    422  
    423 是否登录 : 是 
    424 缓存时间 : 无 
    425 是否分页 : 否 
    426  
    427  
    428 返回结果: 
    429 { 
    430    code : 0成功,-1失败 
    431    message : 提示信息 
    432    version : 接口版本号如1.0,1.0(latest)表示最新版本 
    433 } 
    434 }}} 
    435  
    436  
    437 ==== 1.2.9 移动照片(批量) ==== 
    438 {{{ 
    439 接口/appapi/1.0/album/movePhotos.do [POST] 
    440 说明 :  移动照片(批量) 
    441 请求参数: 
    442      
    443    *albumIdMoveIn : 接收照片相册ID 
    444    *albumIdMoveOut : 被移出照片的相册ID 
    445    *photoIds: 被移动的照片ID,使用“,”连接在一起 
    446     
    447    备注:根据登录信息获取车友会信息 
    448  
    449  
    450 是否登录 : 是 
    451 缓存时间 : 无 
    452 是否分页 : 否 
    453  
    454  
    455 返回结果: 
    456 { 
    457    code : 0成功,-1失败 
    458    message : 提示信息 
    459    version : 接口版本号如1.0,1.0(latest)表示最新版本 
    460 } 
    461 }}} 
    462  
    463468 
    464469=== 1.3 活动相关