[[TOC]] = 医美2.1.0接口文档 = >mrobot代理环境说明： 192.168.10.198：1080(192.168.74.80)[[BR]] 192.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）[[BR]] ps:未到qa阶段，连开发环境调试（若仅做代理，mrobot不存在真正的处理文件，只作转发的功能） [[BR]] 制作地址：http://zzsvn.pconline.com.cn/svn/zt/mobile/gz/lizijie/2015/0313-%ca%b1%c9%d0%cd%f8%d2%bd%c3%c0app/2.0%d3%a3%cc%d2%b0%ef/ [[BR]] bip接口地址：http://trac.pc.com.cn/bip/wiki/sysnotice [[BR]] = 终端协议 = 终端协议：http://rdtrac.pc.com.cn/iphone/wiki/yimei_wap_url [[BR]] ---------- == 制作修改 == 具体修改到时看设计稿 === 项目详情页 === 现有活动栏目名应为“本项目相关活动”，另外调整该栏目样式，增加活动图片、商家名称、抢购人数/即将开始标识，样式同医院主页活动列表页 === 活动详情页 === 购买须知部分增加文字样式，此为后台编辑框需求，需要设计，字段如下： 消费有效期： 预约提醒： 支付与退款： 使用规则： 服务承诺： 联系客服： === 医院主页 === 医院主页添加图片展示 === 日记终端页 === 具体修改内容参照设计稿和需求文档 === 帖子终端页 === 具体修改内容参照设计稿和需求文档 == 1.首页 == ---------- === 1.1帖子精选 === 开发环境：http://dev15.pclady.com.cn/app/essencePostList.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/essencePostList.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/s-900/yimei/cms/essencePostList.xsp **说明** > 获取帖子精选[[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否 **数据来源** >整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||pageNo||页数||int||1||是||= =|| ||pageSize||页面大小||int||10||是||= =|| **返回** {{{#!java { "status": 0, "msg": "请求成功", "pageNo": 1, "pageSize": 20, "total": 100, "data": [ { "cornerType": "角标", "imageUrl": "", "title": "", "message": "", "contentID": 111 } ] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= contentID =||= 内容ID=||= title =||=标题=|| ||= cornerType =||= 角标=||= imageUrl =||=图片地址=|| ||= message =||= 帮主说两句=||= =||= =|| === 1.2帖子精选详情页 === 开发环境：http://dev15.pclady.com.cn/app/essencePostInfoList.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/essencePostInfoList.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/s-900/yimei/cms/essencePostInfoList.xsp **说明** > 获取帖子精选详情页[[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否 **数据来源** >整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||pageNo||页数||int||1||是||= =|| ||pageSize||页面大小||int||10||是||= =|| ||contentID||内容ID||int||= = ||是||= =|| **返回** {{{#!java { "status": 0, "msg": "请求成功", "pageNo": 1, "pageSize": 20, "total": 100, "data":[{ "contentID":"内容ID", "nickName":"", "userID":"", "type":””, "imageUrl":"", "title":"", "commentCount":1, "laudCount":1, "dateTime":"刚刚", "isessence":1, "ispublicationPhoto":1, "hasLaud":1 "isExample":1 } ], "article":[ { "contentID":"", "articleType":1, "title":"标题"} ] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= contentID =||= 内容ID=||= title =||=标题=|| ||= articleType =||= 文章类型 =||= article =||=文章节点=|| === 1.3.获取项目列表（修改） === 开发环境：http://dev15.pclady.com.cn/app/getProjectList.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/getProjectList.jsp [[BR]] mrobot环境：http://mrobot.pclady.com.cn/x-86400/yimei-plastic/app/getProjectList.jsp [[BR]] **说明** >获取部位，项目 **缓存时间** >24小时 **提交方式** >GET **数据来源** > 整形库编辑后台 **修改内容** > 1：请求参数添加appVersion，版本号大于等2.1.0时才返回热点项目 [[BR]] 2：返回参数中一级项目添加desc、imageUrl,type [[BR]] **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||= appVersion =||= 版本号 =||= int =||= "" =||= 否 =||版本号去掉.如2.1.0->210|| **返回** {{{#!java { "status": 0, "msg": "请求成功", "total": 11, "data": [ { "typeID": "1", "name": "一级部位", "desc": "我是小标题", "imageUrl": "", "type":1, "item": [ { "typeID": "101", "name": "二级部位", "item": [ { "typeID": "201", "name": "项目名称" } ] } ] } ] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= typeID =||= 类型ID=||= name =||=部位名称=|| ||= desc =||= 热点项目的描述信息=||= imageUrl =||=热点项目的图片地址=|| ||= type =||= 1：热点项目，0：其它项目=||= =||==|| === 1.4获取案例列表（修改） === 开发环境：http://dev15.pclady.com.cn/app/getExampleList.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/getExampleList.jsp [[BR]] mrobot环境：http://mrobot.pclady.com.cn/x-900/yimei-plastic/app/getExampleList.jsp **说明** >获取案例列表 **缓存时间** >15分钟 **提交方式** >GET **数据来源** > 整形库编辑后台 **修改内容** > 1：请求参数添加appVersion，版本号大于等2.1.0需要返回日记和案例 [[BR]] **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||pageNo||页数||int||1||是|||| ||pageSize||页面大小||int||3||是|||| ||age||年龄段||int||""||否|||| ||positionID||部位ID||String||""||否||部位，一级分类ID、感兴趣ID|| ||subPositionID||部位ID||String||""||否||功效，二级分类ID|| ||projectID||项目ID||String||""||否||三级分类ID|| ||doctorID||医生ID||String||""||否||医生主页中会根据医生来获取案例|| ||businessID||医院ID||String||""||否||医院主页中会根据医院来获取案例|| ||city||城市||String||""||否||首页查询时用到|| ||activityID||活动ID||String||""||否||活动详情页用到|| ||appVersion||版本号||String||""||否||版本号大于等于2.1.0时，需要返回日记和案例|| **返回** {{{#!java { "status": 0, "msg": "请求成功", "pageNo": 1, "pageSize": 20, "total": 100, " data": [ { "contentID": "", "type": 1, "title": "", "desc": "", "imageUrl": [ "", "", "" ], " username": "小美", "time": "2015-01-24", "userType":1, " essence": 1, "publicationPhoto": 1 } ] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= contentID =||=案例ID或日记ID=||= type =||= 类型：1：日记，2：案例=|| ||= title =||=标题=||= desc =||= 描述=|| ||= imageUrl =||=图片=||= username =||= 昵称=|| ||= essence =||=是否精华：1：是，0：否=||= publicationPhoto =||= 是否晒单：1：是，0：否=|| ||= time =||=发布时间=||= userType=||=1：达人，2：医生 =|| == 2.搜索 == ---------- === 2.1热点查询 === 开发环境：http://dev15.pclady.com.cn/app/hotList.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/hotList.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/s-900/yimei/cms/hotList.xsp **说明** > 获取搜索中的热点名称[[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否 **数据来源** >整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| **返回** {{{#!java { "status": 0, "msg": "请求成功", "hot": [ { "type": 1, "name": "" }, { "type": 2, "name": "" } ] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= type =||= 热度分为1-4，热度大小对应不同大小的圆，数量如下：热度1:1个 热度2:2个 热度3:3个 热度4:3个=||= name =||=名称=|| === 2.2搜索 === 开发环境：http://dev15.pclady.com.cn/app/search.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/search.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/s-900/yimei/cms/search.xsp **说明** > 搜索优惠、日记、帖子、医院、医生、项目[[BR]] **缓存时间** >15分钟 **提交方式** > GET **是否登录** > 否 **数据来源** >整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||pageNo||页数||int||1||是||= =|| ||pageSize||页面大小||int||10||是||= =|| ||name||页面大小||String||""||是||= =|| ||type||类型||String||""||是||= 1：优惠、2：日记、3：帖子、4：医院、5：医生、6：项目 =|| 当type为空时，优惠活动、日记/帖子、医院返回三条，医生和项目返回4条，pageNo和pageSize不需要传，不需要返回pageNo、pageSize、total[[BR]] 当type不为空时，需要传pageNo和pageSize,需要返回pageNo、pageSize、total,没数据的节点不需要返回[[BR]] **返回** {{{#!java { "status": 0, "msg": "请求成功", "pageNo": 1, "pageSize": 20, "activity": [], "circle": [], "total":100, "hospital": [ { "hospitalID": 1, "name": "医院名称", "imageUrl": "", "type": 1, "department": "美容科" } ], "doctor": [], "project": [ { "projectID": 201, "name": "项目名称" } ] } }}} **返回参数说明** 活动：http://rdtrac.pc.com.cn/iphone/wiki/yimei1.0.0_api#a4.1获取优惠活动列表 [[BR]] 圈子：http://rdtrac.pc.com.cn/iphone/wiki/yimei2.0.0_api#a2.2获取圈子内容列表 [[BR]] 医生：http://rdtrac.pc.com.cn/iphone/wiki/yimei1.0.0_api#a7.1获取医生列表 [[BR]] ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= activity =||= 活动节点=||= circle =||=圈子节点，包括日记和帖子=|| ||= hospital =||= 医院节点=||= doctor =||=医生节点=|| ||= project =||= 项目节点=||= hospitalID =||=医院ID=|| ||= imageUrl =||= 图片地址=||= department =||=医院科室=|| ||= type =||= 1：普通商户、2：认证商户、3：VIP商户=||=projectID =||=项目ID=|| ---------- == 3.专场 == ---------- === 3.1获取专场详情(修改) === （接口已完成，使用请连开发机代理） [[BR]] 开发环境：http://dev15.pclady.com.cn/app/getSpecial.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/getSpecial.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/x-900/yimei-plastic/app/getSpecial.jsp **说明** >获取专场列表 **缓存时间** >15分钟 **提交方式** >GET **数据来源** > 整形库编辑后台 **修改内容** > 1：返回参数添加guide节点 [[BR]] **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||pageNo||页数||int||1||是|| ||pageSize||页面大小||int||4||是|| || specialID ||专场ID||String||””||是|| **返回** {{{#!java { "status": 0, "msg": "请求成功", "pageNo": 1, "pageSize": 20, "total": 100, "guide": { "guideMessage": "", "guideImageUrl": ["","",""] }, "special": { "title": "陈柯", "city": "广州,深圳,北京", "discount": "", "buyTotal": 12, " imageUrl": "" }, "data": [ { "activitiesID": "", "title": "", "typeName": "", "imageUr": "", "price": 999, "discountPrice": 1, "businessName": "深圳广济医疗美容医院", "doctor": "陈柯", "beginTime": "", "buyTotal": 100, "isEnd": 1 } ] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= guideMessage =||= 专场导语=||= guideImageUrl =||= 专场介绍图=|| == 4.达人标识 == ---------- === 4.1添加达人标识(修改) === 圈子相关接口返回时添加达人标识（userType,userTypeImage），需要修改的接口如下 [[BR]] 精选推荐：http://rdtrac.pc.com.cn/iphone/wiki/yimei2.0.0_api#a1.1精选推荐 [[BR]] 获取圈子内容列表：http://rdtrac.pc.com.cn/iphone/wiki/yimei2.0.0_api#a2.2获取圈子内容列表 [[BR]] 日记详情页： http://rdtrac.pc.com.cn/iphone/wiki/yimei2.0.0_api#a2.4日记详情页WEB页 [[BR]] 帖子详情页： http://rdtrac.pc.com.cn/iphone/wiki/yimei2.0.0_api#a2.5帖子详情页WEB页 [[BR]] 评论列表： http://rdtrac.pc.com.cn/iphone/wiki/yimei2.0.0_api#a2.10评论列表 [[BR]] 用户主页：http://rdtrac.pc.com.cn/iphone/wiki/yimei2.0.0_api#a3.1用户主页 [[BR]] 获取用户资料：http://rdtrac.pc.com.cn/iphone/wiki/yimei1.0.0_api#a11.1获取用户资料 [[BR]] **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= userType =||= 1：达人，2：医生=||= userTypeImage =||= 达人图标=|| == 5.日记 == ---------- === 5.1发日记（修改） === 开发环境：http://dev15.pclady.com.cn/app/addDiary.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/addDiary.jsp [[BR]] **说明** > 发日记 **缓存时间** >0分钟 **提交方式** > POST **是否登录** > 是 **数据来源** >整形库编辑后台 **修改内容** > 1：请求参数添加surgeryDate、nodeDate、appVersion字段[[BR]] 2：当版本号大于210 时，image参数不需要传，content中包括图片和文字，图片用img标签组装 [[BR]] 3：添加diaryDependId参数，审核不通过重新编辑时用到。 [[BR]] **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||= diaryID =||=日记ID =||= string =||= "" =||= 是 =||= 没传ID表示新日记，有ID表示续写 =|| ||= projectID =||=项目ID =||= string =||= "" =||= 是 =||= "三级ID1,三级ID2,三级ID3",类别ID用英文逗号隔开 =|| ||= title =||=标题 =||= string =||= "" =||= 是 =||= =|| ||= content =||=内容 =||= string =||= "" =||= 是 =||= =|| ||= image =||=图片 =||= string =||= "" =||= 是 =||=用;myAppImg;隔开，最多9张=|| ||= orgID =||=机构ID =||= string =||= "" =||= 否 =||= 模糊搜索选择的机构需要传ID ，不用传名称=|| ||= orgName =||=手动输入的机构名 =||= string =||= "" =||= 否 =||= 新增机构需要传名称，不需要ID =|| ||= orgCity =||=机构所在城市 =||= string =||= "" =||= 否 =||= =|| ||= orgDoctorID =||=机构中的医生 =||= string =||= "" =||= 否 =||= 模糊搜索选择的医生需要传ID ，不用传名称 =|| ||= orgDoctorName =||=手动输入的医生 =||= string =||= "" =||= 否 =||= 新增医生需要传名称，不需要ID =|| ||= price =||=价格 =||= string =||= "" =||= 否 =||= =|| ||= orderID =||=订单ID =||= string =||= "" =||= 否 =||=晒单要传订单ID，传入订单号时，机构等信息和项目信息不需要传 =|| ||= surgeryDate =||=手术时间=||= string =||= "" =||= 否 =||=手术时间 ，新增日记时为必填，续写时不需要传 =|| ||= nodeDate =||=当前节点时间 =||= string =||= "" =||= 是 =||=当前节点时间 =|| ||= appVersion =||=版本号 =||= string =||= "" =||= 是 =||=版本号去掉.如2.1.0->210 =|| ||= diaryDependId =||=节点ID =||= string =||= "" =||= 否 =||=审核不通过的日记节点ID =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "Integral":20, "contentID",111111 } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= Integral =||= 奖励积分 =||=contentID=||日记ID，新增的时候返回，续写不需要返回=|| === 5.2日记详情页(修改) === '''(mrobot已完成，请连开发机进行测试)'''[[BR]] 开发环境：http://dev15.pclady.com.cn/app/diaryInfo.jsp?diaryID=111&pageNo=1&pageSize=10&deviceID=91 [[BR]] http://dev15.pclady.com.cn/app/commentList.jsp?contentID=111&contentType=1&pageNo=1&pageSize=3 [[BR]] 线上环境：http://plastic.pclady.com.cn/app/diaryInfo.jsp [[BR]] http://plastic.pclady.com.cn/app/commentList.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/s/yimei/circle/diary.xsp **说明** > 日记终端页，应用端只需要出数据，wap页由mrobot来完成。 **缓存时间** >0分钟 **提交方式** > GET **是否登录** > 查询收藏状态时需要登录，其它情况不需要登录 **数据来源** >整形库编辑后台 **修改内容** > 1：请求参数添加order、appVersion字段[[BR]] 2：返回参数添加userType、surgeryDate、afterDay [[BR]] 3：返回参数删除imageList节点 [[BR]] 4：返回参数添加diaryNode节点 [[BR]] 5：当appVersion大于等于210时，diaryContent返回图片混排 [[BR]] 6：返回参数添加点赞头像节点(2.2.0版本才需要添加) [[BR]] **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||pageNo||页数||int||1||是||= =|| ||pageSize||页面大小||int||10||是||= =|| ||= diaryID =||=日记ID =||= string =||= "" =||= 是 =||= =|| ||= deviceID =||=设备ID =||= string =||= "" =||= 是 =||= =|| ||fmt||fmt=json 时显示接口数据||String||""||否|||| ||order||1:正序，2：倒序||""||否|||| || appVersion ||版本号||""||否|||| **返回** {{{#!java { "status": 0, "msg": "请求成功", "pageNo": 1, "pageSize": 20, "total": 100, "diaryID": "", "hasCollect": "", "diaryTitle": "", "hasLaud": "", "userHead":[ "1234","1234" ], "projectList": [ { "projectID": 11, "projectName": "" }, { "projectID": 11, "projectName": "" } ], "isessence": 1, "ispublicationPhoto": 1, "org": { "hospital": "", "doctor": "", "hospitalCity": "", "price": 1200, "orgID": 111, "doctorID": 11111 }, "nickName": "", "userAge": 30, "userCity": "", "userID": "", "userType": 1, "userTypeImage":"http://7.png", "surgeryDate": "", "afterDay": 1, "commentCount": 1, "laudCount": 2, "activityName": "", "activityID": "", "sysTime": "系统当前时间YYYY-MM-DD HH:mm:ss", "data": [ { "diaryDependId": 111, "createTime": "", "diaryContent": "日记内容", "imageList":["image1","image2","image3"], "largeImageList":["image1","image2","image3"] } ], "diaryNode": [ { "title": "术后一天", "date": "2015-10-10" } ] } html中的json，mrobot组装 { "circleName": "", "commentCount": 1, "laudCount": 2, "hasCollect": "", "hasLaud": 1, "userID": "", "userType":1, "title": "", "data": [ { "largeImageList": [ "image1", "image2", "image3" ] } ], "diaryNode": [ { "title": "术后一天", "date": "2015-10-10" } ] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= hasCollect =||=1：收藏，2：未收藏 =||= diaryTitle =||=日记标题=|| ||= projectID=||=项目ID =||=projectName=||=项目名=|| ||= isessence=||=是否精华：1：是，0：否 =||=ispublicationPhoto=||=是否晒单：1：是，0：否=|| ||= hospital=||=医院名 =||=doctor=||=医生=|| ||= hospitalCity=||=医院所在城市 =||=price=||=价格=|| ||= nickName=||=用户昵称 =||=userAge=||=用户年龄=|| ||= userCity=||=用户所在城市 =||=userID=||=用户头像=|| ||= commentCount=||=评论数 =||=laudCount=||=点赞数=|| ||= userID=||=用户ID为自己时，界面下文显示续写日记 =||=createTime=||=发由时间=|| ||= imageList=||=列表显示小尺寸图片 =||=largeImageList=||=查看时需要请求大尺寸图片=|| ||= hasLaud=||=是否点赞，1：已点赞，0：未点赞 =||=activityName=||=活动名=|| ||= org=||=机构信息，没有机构信息时，不需要返回该节点 =||=diaryDependId=||=日记节点=|| ||= surgeryDate=||=手术日期=||=afterDay=||=日记写到术后多少天=|| ||=diaryNode-> title=||=节点标题，术后XX天 =||=diaryNode->date=||=节点日期=|| == 6.1用户信息 == === 6.1获取用户资料(修改) === 开发环境：http://dev15.pclady.com.cn/app/getUserInfo.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/getUserInfo.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/x/yimei-plastic/app/getUserInfo.jsp **说明** >获取用户的资料 **缓存时间** >0 **提交方式** >GET **是否需要登录** >是 **数据来源** > 整形库编辑后台 **修改** > 第三方登录用户用户名默认读取其昵称 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| **返回** {{{#!java { status:0, msg:”请求成功”, data:{ phoneNum:”13588888888”, nickname:”昵称”, percent:50, headUrl:"", sex:"男", birthday:"1990-09-21", age:70, city:"广东,广州", useProject:" 1, 2", likeProject:" 1, 2", signature:"个性签名", noUse:2, score:123 } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= percent =||= 资料完善的百分比=||= age =||=年龄段=|| ||= useProject =||= 整过的项目=||= likeProject =||=喜欢的项目=|| ||= noUse =||= 未消费的数量=||= score =||=用户总积分=|| == 2.2.0接口 == == 1.首页 == ---------- === 1.1首页数据接口（修改） === 开发环境：http://dev15.pclady.com.cn/app/index.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/index.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/x-900/yimei-plastic/app/index.jsp **说明** > 修改部分：新增首页入口节点（indexEnter），删除特色展示节点（show），修改活动专场节点（activities） **缓存时间** >15分钟 **提交方式** > GET **数据来源** > 焦点图：CMS、特色展示：CMS、活动专场：CMS、猜你喜欢：整形库编辑后台、推荐案例：整形库编辑后台，日记/帖子 **修改内容** > 1：如果版本号小于210，indexEnter节点返回固定的JSON，如下[[BR]] {{{#!java { "status": 0, "msg": "请求成功", "data": [ { "imageUrl": "http://img0.pclady.com.cn/pclady/plastic/ym2015/nq/1508/01.png", "title": "精选机构", "type": 1 }, { "imageUrl": "http://img0.pclady.com.cn/pclady/plastic/ym2015/nq/1508/02.png", "title": "人气项目", "type": 2 }, { "imageUrl": "http://img0.pclady.com.cn/pclady/plastic/ym2015/nq/1508/03.png", "title": "今日秒杀", "type": 3 }, { "imageUrl": "http://img0.pclady.com.cn/pclady/plastic/ym2015/nq/1508/04.png", "title": "领积分", "type": 4 } ] } }}} **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||city||城市||String||""||否|| ||project||感兴趣的项目||String||""||否|| ||age||年龄段||int||""||否|| ||appVersion||版本号||String||"app版本号为x.x.x是，参数 传xxx，去掉小数点"||否|| **返回** {{{#!java { "listFocus": { "status": 0, "msg": "请求成功", "data": [ { "type": 1, "imageUrl": " http://img.pconline.com.cn/7.jpg", "url": "", "contentID": "14324", "circleContentID": "423" } ] }, "indexEnter": { "status": 0, "msg": "请求成功", "data": [ { "imageUrl": " http://img.pconline.com.cn/7.jpg", "title": "功能1" }, { "imageUrl": " http://img.pconline.com.cn/7.jpg", "title": "功能2" } ] }, "activities": { "status": 0, "msg": "请求成功", "data": [ { "type": 1, "imageUrl": "http: //img.pconline.com.cn/7.jpg", "url": "", "contentID": "14324", "circleContentID": "123" } ] }, "guessYouLike": { "status": 0, "msg": "请求成功", "data": [ { "likeID": "24234", "title": "标题", "typeName": "限量30份", "imageUrl": "http: //img.pconline.com.cn/7.jpg", "price": 999, "discountPrice": 1, "businessName": "深圳广济医疗美容医院", "doctor": "陈柯", "beginTime": "2015-05-01", "buyTotal": 100, "isEnd": 1 } ] } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= listFocus =||= 焦点图=||= indexEnter =||=首页入口=|| ||= activities =||= 活动专场=||= guessYouLike =||=猜你喜欢，字段说明参考活动列表=|| === 1.2精选机构 （修改）=== 开发环境：http://dev15.pclady.com.cn/app/indexOrgList.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/indexOrgList.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/s-900/yimei/org/indexOrgList.xsp?pageNo=1&pageSize=10 **说明** >从首页入口进入的精选机构列表 **缓存时间** >15分钟 **提交方式** >GET **数据来源** > 整形库 **修改内容** > 1：请求参数添加order和city字段，用于过滤查询 [[BR]] 2：返回参数添加city节点，用于获取有机构的城市，返回格式为数组 [[BR]] 3：返回参数添加activityTotal，活动总数 [[BR]] **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||pageNo||页数||int||1||是|||| ||pageSize||页面大小||int||10||是|||| ||city||城市名||String||""||否|||| ||order||排序||int||""||否||1：默认排序，2：星级从高到低，3：活动从多到少|| **返回** {{{#!java { "status": 0, "msg": "请求成功", "pageNo": 1, "pageSize": 10, "total": 100, "city": [ "北京", "广州" ], "data": [ { "orgID": 1, "imageUrl": "http: //img.pconline.com.cn/7.jpg", "name": "", "address": "广州", "plScore": 10, "serviceScore": 5, "technologyScore": 3, "environmentScore": 5, "activityTotal": 10 } ] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= orgID =||= 机构ID=||= imageUrl =||=图片=|| ||= name =||= 机构名 =||=address =||= 机构地址=|| ||= plScore =||= 星级 =||=serviceScore =||= 服务=|| ||= technologyScore =||= 技术 =||=environmentScore =||= 环境=|| ||= city =||= pageNo==1&&非过滤查询时才返回该节点，有机构的城市，过滤查询时用到 =||=activityTotal =||= 活动数=|| == 2.帖子 == === 2.1帖子详情页(修改) === '''(mrobot已完成，请连开发机进行测试)'''[[BR]] 开发环境：http://dev15.pclady.com.cn/app/postInfo.jsp [[BR]] http://dev15.pclady.com.cn/app/commentList.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/postInfo.jsp [[BR]] http://plastic.pclady.com.cn/app/commentList.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/s/yimei/circle/topic.xsp **说明** > 帖子终端页，应用端只需要出数据，wap页由mrobot来完成。 **缓存时间** >0分钟 **提交方式** > GET **是否登录** > 查询收藏状态时需要登录，其它情况不需要登录 **数据来源** >整形库编辑后台 **修改内容** >1：返回时添加活动、日记、帖子、医院、医生、项目,点击头像等节点（project、userHead、doctor、hospital、post、diary、activity） [[BR]] 2：请求参数添加appVersion参数 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||pageNo||页数||int||1||是||= =|| ||pageSize||页面大小||int||10||是||= =|| ||= postID =||=帖子ID =||= string =||= "" =||= 是 =||= =|| ||= deviceID =||=设备ID =||= string =||= "" =||= 是 =||= =|| ||fmt||fmt=json 时显示接口json数据||String||""||是||= =|| ||isExample||isExample==1时表示旧案例数据||int||""||= 否 =|| =|| ||hiddenReply||hiddenReply==1时表示客户端请求html，只需要返回帖子内容,并在html中返回json数据||int||""||= 否 =|| =|| ||appVersion||版本号||String||"app版本号为x.x.x是，参数 传xxx，去掉小数点"||否|| =|| **返回** {{{#!java { "status": 0, "msg": "请求成功", "pageNo": 1, "pageSize": 20, "total": 100, "title": "", "nickName": "", "userID": "", "userAge": 1, "userCity": "", "circleName": "", "commentCount": 1, "laudCount": 2, "hasCollect": "", "isessence": 1, "ispublicationPhoto": 1, "hasLaud": 1, "sysTime": "系统当前时间YYYY-MM-DD HH:mm:ss", "data": [ { "postDependId": 122, "content": "", "imageList": [ "image1", "image2", "image3" ], "largeImageList": [ "image1", "image2", "image3" ], "createTime": "", "activity": [ { "activitiesID": "", "title": "", "imageUr": "", "price": "999", "discountPrice": 1 } ], "diary": [ { "contentID": "内容ID", "imageUrl": "", "title": "", "commentCount": 1, "laudCount": 1, "dateTime": "刚刚" } ], "post": [ { "contentID": "内容ID", "imageUrl": "", "title": "", "commentCount": 1, "laudCount": 1, "dateTime": "刚刚" } ], "hospital": [ { "hospitalID": 1, "name": "医院名称", "imageUrl": "", "activityTotal": 1, "exampleTotal": 1, "doctorTotal": 1 } ], "doctor": [ { "name": "陈柯", "doctorID": "", "imageUrl": "", "job": "" } ], "project": [ { "projectID": 201, "name": "项目名称" } ] } ], "projectList": [ { "projectID": 11, "projectName": "" }, { "projectID": 11, "projectName": "" } ], "org": { "hospital": "", "doctor": "", "hospitalCity": "", "price": 1200 },"userHead":[ "1234","1234" ] } html中的json { "circleName":"" "commentCount":1, "laudCount":2, "hasCollect":"" "hasLaud":1, "userID":"", "title":"", "data":[{ "largeImageList":["image1","image2","image3"] " }], } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= title =||=标题=||= data =||=帖子数据=|| ||= nickName =||=发布人昵称=||= userID =||=为自己时，界面下文显示续写帖子=|| ||= age =||=发布人年龄=||= city =||=发布人所在城市=|| ||= circleName =||=圈子名=||= content =||=帖子内容=|| ||= hasCollect =||=1：收藏，2：未收藏 =||= createTime =||=发帖时间=|| ||= commentCount=||=评论数 =||=laudCount=||=点赞数=|| ||= imageList=||=列表显示小尺寸图片 =||=largeImageList=||=查看时需要请求大尺寸图片=|| ||= isessence=||=是否精华：1：是，0：否 =||=ispublicationPhoto=||=是否晒单：1：是，0：否=|| ||= hasLaud=||=是否点赞，1：已点赞，0：未点赞 =||=projectList,org=||=旧案例数据可能会包括这两个节点的信息，没有该数据时，节点也不返回=|| ||= postDependId=||=帖子节点 =||==||==|| == 3评论 == === 3.1回复评论（修改） === 开发环境：http://dev15.pclady.com.cn/app/replyComment.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/replyComment.jsp [[BR]] **说明** > 回复 **缓存时间** >0分钟 **提交方式** > POST **是否登录** > 是 **数据来源** >整形库编辑后台 **修改** >1：请求添加三个参数imageUrl、diaryID，postID[[BR]] **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||= contentID =||=文章ID =||= string =||= "" =||= 是 =||= =|| ||= contentType =||=文章类型 =||= string =||= "" =||= 是 =||= 1：日记，2：帖子=|| ||= replyID =||=回复ID=||= string =||= "" =||= 否 =||=直接评论日记或帖子时，不需要传 =|| ||= replySecondID =||=回复二级ID=||= string =||= "" =||= 否 =||==直接评论日记或帖子时，不需要传 =|| ||= replyContent =||=回复内容=||= string =||= "" =||= 是 =||=回复内容 =|| ||= imageUrl =||=图片=||= string =||= "" =||= 否 =||=图片地址 =|| ||= diaryID =||=日记ID=||= string =||= "" =||= 否 =||=插入日记 =|| ||= postID =||=帖子ID=||= string =||= "" =||= 否 =||=插入帖子 =|| **返回** {{{#!java { "status":0, "msg":"请求成功" "Integral":1 } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= Integral=||=奖励积分=||==||==|| === 3.2评论列表（修改） === '''(mrobot已完成，请连开发机进行测试)'''[[BR]] 开发环境：http://dev15.pclady.com.cn/app/commentList.jsp?contentID=1&contentType=1 [[BR]] 线上环境：http://plastic.pclady.com.cn/app/commentList.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/s/yimei/circle/commentList.xsp **说明** > 获取评论列表 **缓存时间** >0分钟 **提交方式** > GET **是否登录** > 否 **数据来源** >整形库编辑后台 **修改** >1：返回时添加imageUrl参数、diary节点，post节点 [[BR]] **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||pageNo||页数||int||1||是|||| ||pageSize||页面大小||int||10||是|||| ||= contentID =||=文章ID =||= string =||= "" =||= 是 =||= =|| ||= contentType =||=文章类型 =||= string =||= "" =||= 是 =||= 1：日记，2：帖子=|| **返回** {{{#!java { "status":0, "msg":"请求成功", "pageNo": 1, "pageSize": 20, "total":100, "commentCount":1000 "sysTime":"系统当前时间YYYY-MM-DD HH:mm:ss", data[ "commentID":"" "userID":"评论人ID", "nickName":"评论人昵称", "commentTime":"回复时间", "commentContent":"回复内容", "imageUrl":"", "diary":{ "contentID":132, "title":"", "imageUrl":"", "time":"" }, "post":{ "contentID":132, "title":"", "imageUrl":"", "time":"" }, reply:[{ "replyID":"回复ID", "nickName":"跟贴人昵称", "userID":"跟贴人ID", "replyTime":"跟贴时间", "replyContent":"跟贴内容" "replyStarter":"是否楼主回复", "starterNickName":"楼主昵称", "starterID":"楼主ID", "replyToUserID":"回复某人ID", "replyToNickName":"回复某人昵称", " }] ] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= commentID =||= 评论ID =||=replyStarter=||=是否回复楼主1：是，2：否=|| ||= userID =||= 用户ID =||=nickName=||=昵称=|| ||= commentTime =||= 评论时间 =||=commentContent=||=评论内容=|| ||= replyTime =||= 回复时间 =||=replyContent=||=回复内容=|| ||= starterID =||= 楼主ID，用于添加楼主标签 =||=replyContent=||=回复内容=|| ||= replyToUserID =||= 回复某人ID，如果是直接回复评论的，返回为空 =||=replyToNickName=||=回复某人昵称，如果是回复评论的，返回为空=|| ||= total =||= 总数，用于分页 =||=commentCount=||=评论总数=|| == 4.晒单 == === 4.1获取晒单信息 === 开发环境：http://dev15.pclady.com.cn/app/getDiaryByOrder.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/getDiaryByOrder.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/s/yimei/my/getDiaryByOrder.xsp **说明** > 获取审核未通过的晒单信息 **缓存时间** >0 **提交方式** > GET **是否登录** > 是 **数据来源** >整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||pageNo||页数||int||1||是|| ||pageSize||页面大小||int||10||是|| ||orderID||ys||int||10||是|| **返回** {{{#!java { "status":0, "msg":"请求成功", "diaryDependId":111, "contentID":1, "title":"" "diaryContent":"日记内容", "imageList":["image1","image2","image3"] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= contentID =||= 日记ID=||= diaryDependId =||=日记节点ID=|| ||= title =||= 标题=||= diaryContent =||=日记内容=|| ||= imageList =||= 图片地址，返回原图的地址=||= =||==|| === 4.2用户消息列表（修改） === （mrobot已完成，请连开发机进行测试） [[BR]] 开发环境：http://dev15.pclady.com.cn/app/myMessageList.jsp [[BR]] 线上环境：http://plastic.pclady.com.cn/app/myMessageList.jsp [[BR]] mrobot地址： http://mrobot.pclady.com.cn/s/yimei/my/myMessageList.xsp?pageNo=1&pageSize=10 **说明** > 获取用户消息列表 **缓存时间** >0 **提交方式** > GET **是否登录** > 是 **数据来源** >整形库编辑后台 **修改** >1：返回参数修改，审核不通过时，urlType返回6 [[BR]] 2：请求时添加appVersion参数，大于等于2.2.0时要返回晒单不通过的类型 [[BR]] **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||pageNo||页数||int||1||是|| ||pageSize||页面大小||int||10||是|| ||appVersion||版本号||int||10||是|| **返回** {{{#!java { "status":0, "msg":"请求成功", "pageNo": 1, "pageSize": 20, "total": 100, "sysTime":"系统当前时间YYYY-MM-DD HH:mm:ss " "data":[{ "messageID":"", "messageType":1, "replyAccountName":"", "replyAccountId":"", "urlType":””, "title":"" "imageUrl":"", "commentContent":"", "replyContent":"", "createTime":"刚刚", "url":"http" } ] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= replyAccountName =||= 回复人或评论人的昵称，系统消息可不传，APP写死=||= replyAccountId =||=用户ID或系统ID，用于查看ta的主页,系统ID默认为0=|| ||= urlType =||=回复类型 1：日记，2：帖子，3：活动（系统消息可能包括活动推广）,4：外链，5：删除,0：系统消息，6:审核不通过=||= imageUrl =||=推荐图，系统消息中可发送图片=|| ||= commentContent =||=消息内容=||= createTime =||=消息发送时间=|| ||= messageId =||= 消息ID=||= messageType =||=消息类型，0：系统消息，1：评论，2：回复，3：收藏推送=|| ||= url =||= 内容ID或外链，对应urlType，当urlType=4时为外链=||= replyContent =||=回复标题，分别为：日记标题，帖子标题，回复内容，如果只是系统推送的消息，不需要返回=|| ||= title =||= 系统消息标题=||