== 汽车网车友汇项目接口 == === 目录 === 1. [#point100 基本约定 ] 2. [#point200 互动核心平台接口 ] 2.1 [#point201 发送系统消息 ] 2.2 [#point202 获取系统消息 ] 2.3 [#point203 更新系统消息状态 ] 3. [#point300 PASSPORT接口 ] 3.1 [#point301 登录接口 ] 3.2 [#point302 自动激活接口 ] 3.3 [#point303 辨认登录状态接口 ] 4. [#point400 BBS接口 ] 4.1 [#point401 BBS发帖接口 ] 5. [#point500 车友会接口 ] 5.1 [#point501 创建活动 ] 5.2 [#point502 获取活动(行程、成员) ] 5.3 [#point503 创建行程 ] 5.4 [#point504 修改行程 ] 5.5 [#point505 活动报名 ] 5.6 [#point506 删除活动成员 ] 5.7 [#point507 发表活动总结(记账) ] 5.8 [#point508 修改活动总结(记账) ] 5.9 [#point509 上传活动图片 ] 5.10 [#point510 创建用户 ] 5.11 [#point511 修改用户资料 ] 5.12 [#point512 获取用户资料 ] 5.13 [#point513 车友会查询 ] 5.14 [#point514 维护我关注的车友会 ] 5.15 [#point515 获取地区列表 ] 5.16 [#point516 获取评论列表 ] 5.17 [#point517 发表评论 ] 5.18 [#point518 获取推荐活动列表 ] 5.19 [#point519 查询路书 ] 5.20 [#point520 热门推荐 ] 5.21 [#point521 同车友会推荐 ] 5.22 [#point522 同地区推荐 ] 6. [#point600 修改历史 ] === 1. [=#point100 基本约定] === {{{ 1.当接口处理正常时,HTTP STATUS CODE 返回给200。包括有正常的业务数据和数据为空的情况。 2.当接口处理异常时,HTTP STATUS CODE 返回给500,并且给出具体的错误信息。 { "uri" : "/intf/albums-by-type.jsp", "error-code":"20502", "error-desc":"Need you follow uid.", "user-notice":"给用户的提示放在这里" } 3.接口默认的字符编码是UTF-8,接口需要实现对req-enc和resp-enc参数的支持。在JSP的最顶部,实现类似下面的代码: String queryString = request.getQueryString(); String requestEncoding = getParam(queryString,"req_enc"); String responseEncoding = getParam(queryString,"resp_enc"); if(isNotBlank(requestEncoding)){ request.setCharacterEncoding(requestEncoding); } if(isNotBlank(responseEncoding)){ response.setCharacterEncoding(responseEncoding); } 4.所有有写操作的数据接口,必须用POST方式提交,在接口里需要判断提交方式,拒绝GET的调用请求。 5.接口中的JSON字符串,key都用双引号("")包裹,value是字符串类型时,也用双引号("")包裹;是数字类型时,不用引号。 }}} == 2. [=#point200 互动核心平台接口 ] == === 2.1 [=#point201 发送系统消息 ] === === 2.2 [=#point202 获取系统消息 ] === === 2.3 [=#point203 更新系统消息状态 ] === == 3. [=#point300 PASSPORT接口 ] == === 3.1 [=#point301 登录接口 ] === === 3.2 [=#point302 自动激活接口 ] === === 3.3 [=#point303 辨认登录状态接口 ] === == 4. [=#point400 BBS接口 ] == === 4.1 [=#point401 BBS发帖接口 ] === == 5. [=#point500 车友会接口 ] == === 5.1 [=#point501 创建活动 ] === === 5.2 [=#point502 获取活动(行程、成员) ] === === 5.3 [=#point503 创建行程 ] === === 5.4 [=#point504 修改行程 ] === === 5.5 [=#point505 活动报名 ] === === 5.6 [=#point506 删除活动成员 ] === === 5.7 [=#point507 发表活动总结(记账) ] === === 5.8 [=#point508 修改活动总结(记账) ] === === 5.9 [=#point509 上传活动图片 ] === === 5.10 [=#point510 创建用户 ] === === 5.11 [=#point511 修改用户资料 ] === === 5.12 [=#point512 获取用户资料 ] === === 5.13 [=#point513 车友会查询 ] === === 5.14 [=#point514 维护我关注的车友会 ] === === 5.15 [=#point515 获取地区列表 ] === === 5.16 [=#point516 获取评论列表 ] === === 5.17 [=#point517 发表评论 ] === === 5.18 [=#point518 获取推荐活动列表 ] === === 5.19 [=#point519 查询路书 ] === === 5.20 [=#point520 热门推荐 ] === === 5.21 [=#point521 同车友会推荐 ] === === 5.22 [=#point522 同地区推荐 ] === == 5. [=#point500 车友会接口 ] == == 6. =#point600 修改历史 ] ==