[[TOC]] = 医美1.0.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]] == CMS终端页地址 == http://zzsvn.pconline.com.cn/svn/other/archives/zt/mobile/gz/lizijie/2015/0313-%ca%b1%c9%d0%cd%f8%d2%bd%c3%c0app/ [[BR]] http://www1.pclady.com.cn/zt/wap/gz20150324/ymapp/css/ymapp.css [[BR]] == 1.CMS == === 1.1引导页项目列表(CMS) === (接口已完成,使用请连开发机代理) [[BR]] CMS地址: http://plastic.pclady.com.cn/ym2015/nq/1503/intf7167.js [[BR]] mrobot地址: http://mrobot.pclady.com.cn/x-86400-g2u/yimei-cms/ym2015/nq/1503/intf7167.js **说明** >获取引导页中的项目, ID对应整形库中的,但名称可能不一样。 **缓存时间** >24小时 **提交方式** >GET **数据来源** > CMS **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| **返回** {{{#!java { "status":0, "msg":”请求成功”, "data":[{ typeID:"1", name:”眼部” }] } }}} ---------- === 1.2焦点图(CMS) === (接口已完成,使用请连开发机代理) [[BR]] CMS地址: http://plastic.pclady.com.cn/ym2015/nq/1503/intf7187.js [[BR]] mrobot地址:http://mrobot.pclady.com.cn/x-900-g2u/yimei-cms/ym2015/nq/1503/intf7187.js **说明** >获取焦点图,最多5张 **缓存时间** >15分钟 **提交方式** >GET **数据来源** > CMS **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| **返回** {{{#!java { status:0, msg:”请求成功”, data:[{ type:1, imageUrl:” http://img.pconline.com.cn/7.jpg”, url:”” , contentID:”14324” }] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= type =||= //1:活动详情页,2:专场详情页,3,案例详情页,4:项目详情页,5:外链URL,6:活动列表,7:专场列表,8:案例列表,9:我的积分=||= contentID =||=文章类的ID=|| ||= url =||= 如果类型为5,需要URL =||= =||= =|| ---------- === 1.3特色展示(CMS) === (接口已完成,使用请连开发机代理) [[BR]] CMS地址: http://plastic.pclady.com.cn/ym2015/nq/1503/intf7207.js [[BR]] mrobot地址: http://mrobot.pclady.com.cn/x-900-g2u/yimei-cms/ym2015/nq/1503/intf7207.js **说明** >获取特色展示,2条 **缓存时间** >15分钟 **提交方式** >GET **数据来源** > CMS **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| **返回** {{{#!java { status:0, msg:”请求成功”, data: [{ showTitle:”一元秒杀”, showDesc:”有积分就是任性”, imageUrl:” http://img.pconline.com.cn/7.jpg”, url:””, type:1, contentID:”14324” }] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= type =||= //1:活动详情页,2:专场详情页,3,案例详情页,4:项目详情页,5:外链URL,6:活动列表,7:专场列表,8:案例列表,9:我的积分,10:一元秒杀=||= contentID =||=文章类的ID=|| ||= url =||= 如果类型为5,需要URL =||= showDesc =||=描述信息 =|| ---------- === 1.4活动专场(CMS) === (接口已完成,使用请连开发机代理) [[BR]] CMS地址: http://plastic.pclady.com.cn/ym2015/nq/1503/intf7208.js [[BR]] mrobot地址:http://mrobot.pclady.com.cn/x-900-g2u/yimei-cms/ym2015/nq/1503/intf7208.js **说明** >获取活动专场,3条 **缓存时间** >15分钟 **提交方式** >GET **数据来源** > CMS **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| **返回** {{{#!java { status:0, msg:”请求成功”, data: [{ title:”新年美肤专场,水嫩肌肤换出来”, imageUrl:”http://img.pconline.com.cn/7.jpg”, specialID:”14242” }] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =|| ||= specialID =||=专场ID=|| ---------- === 1.5城市列表(CMS) === (接口已完成,使用请连开发机代理) [[BR]] CMS地址: http://plastic.pclady.com.cn/ym2015/nq/1503/intf7227.js [[BR]] mrobot地址:http://mrobot.pclady.com.cn/x-86400-g2u/yimei-cms/ym2015/nq/1503/intf7227.js[[BR]] http://plastic.pclady.com.cn/ym2015/nq/1508/intf9007.js [[BR]] **说明** >获取活动专场,3条 **缓存时间** >24小时 **提交方式** >GET **数据来源** > CMS **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| **返回** {{{#!java { "status":0, "msg":"请求成功", "data": [“北京”,”上海”,”广州”] } }}} == 2.用户 == ---------- === 2.1新增用户 === 开发环境:http://dev15.pclady.com.cn/app/addUser.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/addUser.jsp [[BR]] **说明** >注册成功后,通知平台添加用户和积分 **缓存时间** >0 **提交方式** >POST **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||r||时间截||String||""||是|| ||sign||MD5加密串||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功” } }}} ---------- === 2.2提交感兴趣的项目 === 开发环境:http://dev15.pclady.com.cn/app/addLikeProject.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/addLikeProject.jsp [[BR]] **说明** >用于提交引导页中感兴趣的项目,卸载APP后再次提交时,覆盖添加 **缓存时间** >0 **提交方式** > POST **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||age||年龄段||String||""||否|||| ||project||项目列表||String||""||否||列表|| **返回** {{{#!java { status:0, msg:”请求成功” } }}} ---------- === 2.3分享好友 === 开发环境:http://dev15.pclady.com.cn/app/shareFriend.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/shareFriend.jsp [[BR]] **说明** >分享好友,辊积分 **缓存时间** >0 **提交方式** > GET **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||userId||用户ID||String||""||否|||| **返回** 后期会做一个分享的界面,请求时只是在参数中加一个用户ID == 3.首页 == ---------- === 3.1首页数据接口 === (接口已完成,使用请连开发机代理) [[BR]] 开发环境: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 **说明** > 获取首页数据,包括焦点图(最多5条)、特色展示(2条)、活动专场(3条)、猜你喜欢(3条)、推荐案例(3条) **缓存时间** >15分钟 **提交方式** > GET **数据来源** > 焦点图:CMS、特色展示:CMS、活动专场:CMS、猜你喜欢:整形库编辑后台、推荐案例:整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||city||城市||String||""||否|| ||project||感兴趣的项目||String||""||否|| ||age||年龄段||int||""||否|| **返回** {{{#!java { listFocus:{ status:0, msg:”请求成功”, data:[{ type:1, imageUrl:” http://img.pconline.com.cn/7.jpg”, url:”” , contentID:”14324” }] }, show:{ status:0, msg:”请求成功”, data:[{ showTitle:”一元秒杀”, showDesc:”有积分就是任性”, imageUrl:” http://img.pconline.com.cn/7.jpg”, url:””, type:1, contentID:”14324” }] }, activities:{ status:0, msg:”请求成功”, data:[{ title:”新年美肤专场,水嫩肌肤换出来”, imageUrl:”http://img.pconline.com.cn/7.jpg”, specialID:”14242” }]}, 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 =||= 焦点图=||= show =||=特色展示=|| ||= activities =||= 活动专场=||= guessYouLike =||=猜你喜欢,字段说明参考活动列表=|| ---------- === 3.2获取专场列表 === (接口已完成,使用请连开发机代理) [[BR]] 开发环境:http://dev15.pclady.com.cn/app/getSpecialList.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getSpecialList.jsp [[BR]] mrobot地址: http://mrobot.pclady.com.cn/x-900/yimei-plastic/app/getSpecialList.jsp **说明** >获取专场列表 **缓存时间** >15分钟 **提交方式** >GET **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||pageNo||页数||int||1||是|| ||pageSize||页面大小||int||4||是|| **返回** {{{#!java { status:0, msg:”请求成功”, pageNo: 1, pageSize: 20, total: 100, data:[{ title:"陈柯", specialID:””, city:”广州,深圳,北京”, discount:””, buyTotal:12, imageUrl:"" }] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= discount =||= 折扣=||= buyTotal =||=预售销量=|| ---------- === 3.3获取专场详情 === (接口已完成,使用请连开发机代理) [[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 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||pageNo||页数||int||1||是|| ||pageSize||页面大小||int||4||是|| || specialID ||专场ID||String||””||是|| **返回** {{{#!java { status:0, msg:”请求成功”, pageNo: 1, pageSize: 20, total: 100, special:{ title:"陈柯", city:”广州,深圳,北京”, discount:””, buyTotal:12, imageUrl:"" }, data: [{ activitiesID:””, title:””, typeName:””, imageUrl””, price:999, discountPrice:1, businessName:”深圳广济医疗美容医院”, doctor:”陈柯”, beginTime:””, buyTotal:100, isEnd:1 } ] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= typeName =||= 角标名称=||= price =||= 单价=|| ||= discountPrice =||= 优惠价=||= buyTotal =||= 抢购人数=|| ||= isEnd =||= 1:已结束,2未结束=||= special =||=专场信息 =|| == 4.活动 == ---------- === 4.1获取优惠活动列表 === (接口已完成,使用请连开发机代理) [[BR]] 开发环境:http://dev15.pclady.com.cn/app/getDiscountActivitiesList.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getDiscountActivitiesList.jsp [[BR]] mrobot: http://mrobot.pclady.com.cn/x/yimei-plastic/app/getDiscountActivitiesList.jsp **说明** >获取优惠活动列表 **缓存时间** >0 **提交方式** > GET **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||pageNo||页数||int||1||是|||| ||pageSize||页面大小||int||10||是|||| || project ||项目||String||""||否||项目ID,过滤的项目|| ||age||年龄段||int||""||否|||| ||city||城市||String||""||否||过滤时用到的城市|| ||locationCity||城市||String||""||否||用户所在城市|| ||specialID||专场||String||""||否||专场ID|| ||order||排序||String||""||否||排序规则1:销量,2:价格,默认为空|| ||businessID||商家||String||""||否||从医院进入更多界面时需要根据商家ID请求|| ||buyOther||购买了该活动的用户还购买了其它的。||String||"1"||否||传1表示需要过滤|| ||activityID||活动ID||String||""||否||buyOther用到时需要传|| ||bFilter||是否是过滤查询||String||"1"||否||传1时表示过滤查询|| ||secKill||过滤秒杀活动||String||"1"||否||传1时表示只查询秒杀的活动,不传时不做处理|| 过滤时city、project、order都可以不为空,组合查询。但其它参数不需要传 buyother不为空时还需要要传个活动ID **返回** {{{#!java { status:0, msg:”请求成功”, pageNo: 1, pageSize: 20, total: 100, data:[{ activitiesID:””, title:””, typeName:””, imageUrl””, price:999, discountPrice:1, businessName:”深圳广济医疗美容医院”, doctor:”陈柯”, beginTime:””, buyTotal:100, state:1, surplusTotal:1, total:0 } ] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= typeName =||= 角标名称=||= price =||=单价=|| ||= discountPrice =||= 优惠价=||= buyTotal =||=已抢购数量=|| ||= state =||= 状态:1:进行中,2:未开始,3:已结束=||= beginTime =||=开始抢购时间=|| ||= surplusTotal =||=剩余数量=||=total =||=库存(surplusTotal=0&total=0不限购,surplusTotal=0&total!=0已售空)=|| ---------- === 4.2获取活动详情(web页) === (接口已完成,使用请连开发机代理) [[BR]] 开发环境: http://dev15.pclady.com.cn/app/getActivitesInfo.jsp [[BR]] 线上环境: http://plastic.pclady.com.cn/app/getActivitesInfo.jsp [[BR]] mrobot: http://mrobot.pclady.com.cn/x/yimei-plastic/app/getActivitesInfo.jsp [[BR]] **说明** >获取活动详情 **缓存时间** >0 **提交方式** >GET **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||activitiesID||活动||String||""||是|| ||appVersion||版本号||String||""||否|| ||showDownload||显示下文的下载栏,1:显示,没传此参数时就不显示||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, data:{ businessID:"商家ID", needScore:200, totalScore:1000, canUseScore:100, frontMoney:300, canBuyTotal:1, surplusTotal:3, title:"活动标题", imageUrl:"", price:100, discountPrice:11, state:1, hasCollect:1, total:0, countUrl:"", html:"" } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= needScore =||= 所需积分=||= totalScore =||=用户总积分=|| ||= frontMoney =||= 定金=||= canBuyTotal =||=限购数量=|| || canUseScore||本次活动可以使用的积分|| surplusTotal ||剩余数量|| || title||活动标题|| imageUrl ||活动图片|| || price||原价|| discountPrice ||优惠价|| || state||状态:1:进行中,2:未开始,3:已结束||= hasCollect =||= 1:收藏,2:未收藏=|| ||= surplusTotal =||=剩余数量=||=total =||=库存(surplusTotal=0&total=0不限购,surplusTotal=0&total!=0已售空)=|| ||=countUrl=||=广告的计数器地址=||==||==|| == 5.案例 == ---------- === 5.1获取案例列表 === (接口已完成,使用请连开发机代理) [[BR]] 开发环境: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 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=|| ||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||""||否||活动详情页用到|| **返回** {{{#!java { status:0, msg:”请求成功”, pageNo: 1, pageSize: 20, total: 100, data:[{ exampleID:””, title:””, desc:””, imageUrl:["","",""], username:"小美", time:"2015-01-24", essence:1, publicationPhoto:1 } ] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= essence =||=是否精华:1:是,0:否=||= publicationPhoto =||= 是否晒单:1:是,0:否=|| ---------- === 5.2获取晒单/案例详细信息(web页)=== (接口已完成,使用请连开发机代理) [[BR]] 开发环境:http://dev15.pclady.com.cn/app/getExampleInfo.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getExampleInfo.jsp [[BR]] mrobot: http://mrobot.pclady.com.cn/x-3600/yimei-plastic/app/getExampleInfo.jsp [[BR]] **说明** >获取案例详情信息,返回的标签点击后要做处理 **缓存时间** >1小时 **提交方式** >GET **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||exampleID||案例ID||String||""||是|| ||showDownload||显示下文的下载栏,1:显示,没传此参数时就不显示||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, data:[{ exampleID:””, title:”案例标题”, desc:”案例描述”, imageUrl:案例图片地址, hasCollect:1 } ] } }}} == 6.医院 == ---------- === 6.1医院主页(web) === 开发环境:http://dev15.pclady.com.cn/app/getBusiness.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getBusiness.jsp [[BR]] mrobot: http://mrobot.pclady.com.cn/x-3600/yimei-plastic/app/getBusiness.jsp [[BR]] **说明** >获取商家信息 **缓存时间** >1小时 **提交方式** >GET **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||businessID||商家|| String ||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, html:"" } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ---------- === 6.2获取医院详细信息(web页) === 开发环境:http://dev15.pclady.com.cn/app/getBusinessInfo.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getBusinessInfo.jsp [[BR]] mrobot: http://mrobot.pclady.com.cn/x-3600/yimei-plastic/app/getBusinessInfo.jsp [[BR]] **说明** > 获取医院详细信息 **缓存时间** >1小时 **提交方式** >GET **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||businessID ||活动||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, data:{ html:"" } } }}} == 7.医生 == ---------- === 7.1获取医生列表 === 开发环境:http://dev15.pclady.com.cn/app/getDoctorList.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getDoctorList.jsp [[BR]] mrobot环境:http://mrobot.pclady.com.cn/x-900/yimei-plastic/app/getDoctorList.jsp [[BR]] **说明** >根据医院信息获取医生列表 **缓存时间** >15分钟 **提交方式** >GET **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||pageNo||页数||int||1||是|| ||pageSize||页面大小||int||3||是|| ||businessID||医院||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, pageNo: 1, pageSize: 20, total: 100, data:[{ name:"陈柯", doctorID:””, imageUrl:””, job:”” }] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =|| || job ||职位名称|| ---------- === 7.2医生主页=== 开发环境:http://dev15.pclady.com.cn/app/getDoctor.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getDoctor.jsp [[BR]] mrobot环境:http://mrobot.pclady.com.cn/x-3600/yimei-plastic/app/getDoctor.jsp [[BR]] **说明** >获取商家信息 **缓存时间** >1小时 **提交方式** >GET **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||doctorID||医生|| String ||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, data:{ doucorID:"31", imageUrl:"图片地址", job:"医生职位", name:"医生姓名", businessName:"医院姓名", desc:"医生详情", example:{ total:20, list:[{ title:”变美过程全记录”, desc:””, imageUrl:”http://img.pconline.com.cn/7.jpg, http://img.pconline.com.cn/7.jpg, http://img.pconline.com.cn/7.jpg”, username:”小美”, time:”2015-01-14”, essence:1, publicationPhoto:1, exampleID:”” }] } } } }}} ---------- === 7.3获取医生详细信息(web页) === 开发环境:http://dev15.pclady.com.cn/app/getDoctorInfo.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getDoctorInfo.jsp [[BR]] mrobot: http://mrobot.pclady.com.cn/x-3600/yimei-plastic/app/getDoctorInfo.jsp [[BR]] **说明** > 获取医生详细信息 **缓存时间** >1小时 **提交方式** >GET **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||doctorID ||医生ID||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, data:{ html:"" } } }}} ---------- == 8.获取部位和项目列表 == 开发环境: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 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| **返回** {{{#!java { status:0, msg:”请求成功”, total:11, data:[{ typeID:"1", name:”一级部位”, item:[{ typeID:”101”, name:”二级部位” item:[{ typeID:”201”, name:”项目名称” }] }] }] } }}} == 9.订单 == ---------- === 9.1提交订单=== 开发环境:http://dev15.pclady.com.cn/app/createOrder.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/createOrder.jsp [[BR]] **说明** >抢购后生成订单 **缓存时间** >0 **提交方式** >POST **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||activitiesID||活动||String||""||是|| ||total||购买数量|| int ||""||是|| ||phone||手机号||String||""||是|| ||useScore||兑换的积分||String||""||是|| ||contacts||联系人||String||""||是|| ||appVersion||版本号1.1.0加入的,区分1.0.0中没有联系人||String||""||是|| ||r||时间截||String||""||是|| ||sign||MD5加密串||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, orderID:"12424234234", orderNO:"流水号ID", password:"消费密码,金额为0时,直接购买成功,返回消费密码" } }}} ---------- === 9.2获取用户订单 === 开发环境:http://dev15.pclady.com.cn/app/getUserOrderList.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getUserOrderList.jsp [[BR]] mrobot地址: http://mrobot.pclady.com.cn/x/yimei-plastic/app/getUserOrderList.jsp **说明** >获取我的订单 **缓存时间** >0 **提交方式** >GET **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||pageNo||页数||int||1||是|| ||pageSize||页面大小||int||4||是|| ||orderType ||订单类型//1:全部,2:未消费,3:已消费,4:待付款||int||""||是|| ||r||时间截||String||""||是|| ||sign||MD5加密串||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, pageNo: 1, pageSize: 20, total: 100, data:[{ orderID:"123442342", imageUrl:””, title:”订单标题”, priceTotal:600, total:2, failureTime:”2015-04-04 12:30:59”, endTime:”2015-04-04 12:30:59”, useTime:”2015-04-04 12:30:59”, delayTime:”2015-04-04 12:30:59”, orderTime:”2015-04-04 12:30:59”, state:1, showOrderID:"23423432", activitiesID:’111111’, checkState:1, useScore:10, orderNO:"流水号", phone:"下单手机号", contacts:"联系人" }] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||priceTotal||总价||failureTime||失效时间,未付款时用到|| ||useTime ||消费时间||endTime ||活动结束时间|| ||delayTime||消费最后期限||state||1:待付款,2:未消费,3:已消费,4:已失效,5:已过期,6:已退款 || || showOrderID||晒单ID|| orderTime ||下单时间|| || total||购买的数量|| imageUrl ||图片地址|| || checkState || 0初始化,1编辑审核通过,2,审核平台审核通过,-1审核不通过,-2审核平台不通过,-3编辑删除,-4网友删除 -5 晒单初始化|| useScore|| 兑换的积分|| ---------- === 9.3获取订单详情 === 开发环境:http://dev15.pclady.com.cn/app/getOrderInfo.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getOrderInfo.jsp [[BR]] mrobot: http://mrobot.pclady.com.cn/x/yimei-plastic/app/getOrderInfo.jsp [[BR]] **说明** >获取订单详情 **缓存时间** >0 **提交方式** >GET **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||orderID ||订单||int||""||是|| ||r||时间截||String||""||是|| ||sign||MD5加密串||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, data:{ phone:"13588888888", userTotalScore:1000, canUseScore:300, failureTime:30, orderState:1, orderTime:2015-04-04 12:30:59, contacts:"联系人" pwd:[{ password:”111111”, state:1, showPhotoID:””, userTime:”2015-02-02 12:30:59”, delayTime:2015-04-04 12:30:59 }] } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| || canUseScore ||本交活动可以消费的积分,去支付时需要用到|| userTotalScore ||用户总积分|| || password ||消费密码|| showPhotoID ||晒单ID|| || state ||消费券的订单状态,0 未消费 1 已消费 -1已过期 -2已失效||userTime ||消费时间|| || failureTime ||多少分钟后过期,待支付时用到|| orderState||订单状态:0 未付款 1未消费 2 已消费 -1 已失效 -2已过期 -3已退款|| || delayTime ||消费券失效时间||orderTime ||下单时间|| ---------- === 9.4取消用户订单 === 开发环境:http://dev15.pclady.com.cn/app/cancelOrder.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/cancelOrder.jsp [[BR]] mrobot: http://mrobot.pclady.com.cn/x/yimei-plastic/app/cancelOrder.jsp [[BR]] **说明** >取消订单 **缓存时间** >0 **提交方式** >GET **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||orderID ||订单||String||""||是|| ||r||时间截||String||""||是|| ||sign||MD5加密串||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功” } }}} ---------- === 9.5获取用户消费密码 === 开发环境:http://dev15.pclady.com.cn/app/getUsePassword.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getUsePassword.jsp [[BR]] mrobot: http://mrobot.pclady.com.cn/x/yimei-plastic/app/getUsePassword.jsp [[BR]] **说明** >支付成功后获取用户的消费密码 **缓存时间** >0 **提交方式** >GET **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||orderID ||订单||string||""||是|| ||r||时间截||String||""||是|| ||sign||MD5加密串||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, data:{ password:[123456,123124,432423] } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= score =||= 奖励的积分=||= password =||= 消费密码=|| ---------- === 9.6创建微信订单=== 开发环境:http://dev15.pclady.com.cn/app/createWechatOrder.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/createWechatOrder.jsp [[BR]] **说明** >生成微信订单 **缓存时间** >0 **提交方式** >POST **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| || orderNO ||流水号ID||String||""||是|| ||r||时间截||String||""||是|| ||sign||MD5加密串||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, timestamp:"时间戳", appid:"应用ID", partnerid:"商户ID", prepayid:"预支付订单", noncestr:"随机串", package:"商家根据财付通文档填写的数据和签名", sign:"签名" } }}} ---------- === 9.7支付结果提交=== 开发环境:http://dev15.pclady.com.cn/app/submitPayResult.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/submitPayResult.jsp [[BR]] **说明** >抢购后生成订单 **缓存时间** >0 **提交方式** >POST **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| || orderNO ||流水号ID||String||""||是|| || payTime ||支付时间:yyyyMMddhhmmss||String||""||是|| || payStatus||支付状态,支付返回的状态0:成功,-1:失败,-2:取消||String||""||是|| || payType||支付类型 1=支付宝,2=微信||String||""||是|| || payMessage ||支付信息,支付结果信息,如支付成功,取消支付,支付失败||String||""||是|| ||r||时间截||String||""||是|| ||sign||MD5加密串||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, } }}} ---------- === 9.8获取未支付订单数量=== 开发环境:http://dev15.pclady.com.cn/app/getNoPayTotal.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getNoPayTotal.jsp [[BR]] **说明** >抢购后生成订单 **缓存时间** >0 **提交方式** >POST **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||r||时间截||String||""||是|| ||sign||MD5加密串||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, total:"", hasSignIn:1 } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= total =||= 未付款数量=||= hasSignIn =||= 是否签到,1:已签到,0:未签到=|| ---------- === 9.9抢购接口=== 开发环境:http://dev15.pclady.com.cn/app/quickBuy.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/quickBuy.jsp [[BR]] **说明** >抢购后生成订单 **缓存时间** >0 **提交方式** >POST **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| || activityID ||活动ID||String||""||是|| ||r||时间截||String||""||是|| ||sign||MD5加密串||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, type:"", surplusTotal:"剩余数量", phone:"", contacts:"联系人", total:1 } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= type =||= 0:正常,1:成功下单但未支付,2:超过限额,3:有锁定的=||= surplusTotal =||= 剩余数量=|| ||= phone =||= 上次下单的手机号=||= total=||= 库存 (surplusTotal=0&total=0不限购,surplusTotal=0&total!=0已售空)=|| == 10.积分 == ---------- === 10.1获取用户积分 === 开发环境:http://dev15.pclady.com.cn/app/getUserScore.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getUserScore.jsp [[BR]] mrobot地址: http://mrobot.pclady.com.cn/x/yimei-plastic/app/getUserScore.jsp **说明** >获取用户积分 **缓存时间** >0 **提交方式** >GET **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| **返回** {{{#!java { status:0, msg:”请求成功”, data:{ scoreTotal:"105", days:5, canGetScore:5, monthIn:110, monthOut:50, hasGetScore:1 } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| || scoreTotal ||用户总积分|| days ||连续签到天数|| || monthIn ||近一个月进账|| monthOut ||近一个月支出|| || canGetScore||今天可领积分|| hasGetScore ||1:已签到,0:未签到|| ---------- == 10.2获取历史积分 == 开发环境:http://dev15.pclady.com.cn/app/getUserScoreList.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getUserScoreList.jsp [[BR]] mrobot地址: http://mrobot.pclady.com.cn/x/yimei-plastic/app/getUserScoreList.jsp **说明** >获取用户历史积分 **缓存时间** >0 **提交方式** >GET **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||pageNo||页数||int||1||是|| ||pageSize||页面大小||int||4||是|| **返回** {{{#!java { status:0, msg:”请求成功”, pageNo: 1, pageSize: 20, total: 100, data:[{ content:"参加活动", time:”2015-04-15 12:30”, type:”1” , score:200 }] } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| || content ||积分详情|| score ||消费积分|| || type ||1:进账,2:支出|| time ||消费时间|| == 11.用户信息 == ---------- === 11.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 =||=用户总积分=|| ---------- === 11.2完善用户资料 === 开发环境:http://dev15.pclady.com.cn/app/updateUserInfo.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/updateUserInfo.jsp [[BR]] **说明** >完善用户资料 **缓存时间** >0 **提交方式** >POST **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 说明 =|| ||nickname ||昵称||String||""||否|||| ||sex ||性别||String||"2"||否||1:男,2:女|| ||birthday ||生日||String||""||否||格式:YYYY-MM-DD|| ||age ||年龄段||int||""||是|||| ||city ||城市||String||""||否||一般城市:广东,广州,直辖:北京|| ||likeProject ||感兴趣的项目||String||""||是||ID1,ID2,ID3|| ||useProject ||整过的项目||String||""||是||ID1,ID2,ID3|| ||signature ||个性签名||String||""||是|||| **返回** {{{#!java { status:0, msg:”请求成功” } }}} ---------- === 11.3签到 === 开发环境:http://dev15.pclady.com.cn/app/getMyScore.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getMyScore.jsp [[BR]] **说明** >签到 **缓存时间** >0 **提交方式** >POST **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||r||时间截||String||""||是|| ||sign||MD5加密串||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, score:115 } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =|| || score ||用户总积分|| ---------- == 12.获取标签列表 == (V1.0.0不需提供) > getLabelList **说明** >根据活动获取标签,标签读取该活动归属的项目二级分类下的所有项目名称 **缓存时间** >15分钟 **提交方式** >GET **数据来源** > 提交给整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||activitiesID||活动ID|| String ||""||是|| **返回** {{{#!java { status:0, msg:”请求成功”, data:[{labelID:1111, labelName:"双眼皮"}] } }}} == 13.晒单 == ---------- === 13.1发表晒单 ===(V1.0.0不需提供) > showOrder **说明** >购买成功后可以发表晒单 **缓存时间** >0 **提交方式** >POST **是否需要登录** >是 **数据来源** > 提交给整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||orderID||订单号|| String ||""||是|| ||title||标题|| String ||""||是|| ||content||内容|| String ||""||是|| ||image||图片地址|| String ||""||是|| ||label||标签|| String ||""||否|| **返回** {{{#!java { status:0, msg:”请求成功” } }}} == 14.项目介绍 == ---------- === 14.1获取项目介绍信息 (web页)=== 开发环境:http://dev15.pclady.com.cn/app/getProjectInfo.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getProjectInfo.jsp [[BR]] mrobot: http://mrobot.pclady.com.cn/x-3600/yimei-plastic/app/getProjectInfo.jsp [[BR]] **说明** >获取案例列表 **缓存时间** >1小时 **提交方式** >GET **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||projectID||项目ID||String||""||是|| ||locationCity||定位城市||String||""||否|| **返回** {{{#!java { status:0, msg:”请求成功”, data:{ html:”” } } }}} ---------- == 15.意见反馈 /版本更新== **说明** >调用魔方 ---------- == 16.登录/注册/重置密码/修改密码== **说明** >调用passport ---------- == ---------1.1.0接口---------== === 2.3分享好友 === 开发环境:http://dev15.pclady.com.cn/app/shareFriend.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/shareFriend.jsp [[BR]] **说明** >分享好友,加积分 **缓存时间** >0 **提交方式** > POST **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||r||时间截||String||""||是|| ||sign||MD5加密串||String||""||是|| **返回** {{{#!java { status:0, msg:”请求成功” } }}} ---------- == 12.用户收藏 == ---------- === 12.1收藏/取消收藏 ===(V1.1.0) 开发环境:http://dev15.pclady.com.cn/app/collectForApp.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/collectForApp.jsp [[BR]] > collectForApp **说明** >用于添加收藏和取消收藏 **缓存时间** >0 **提交方式** >POST **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||typeID||类型ID,分别为活动ID、案例ID|| String ||""||是|| ||type||类型:1:活动,2:案例|| int ||""||是|| ||operation||操作:1:收藏,2:取消收藏|| int ||""||是|| **返回** {{{#!java { status:0, msg:”请求成功” } }}} ---------- === 12.2获取收藏列表 ===(V1.1.0) ***mrobot已完成,可连开机机进行测试 *** 开发环境:http://dev15.pclady.com.cn/app/getCollectList.jsp [[BR]] 线上环境:http://plastic.pclady.com.cn/app/getCollectList.jsp [[BR]] mrobot环境接口 [[BR]] > http://mrobot.pclady.com.cn/s/yimei/my/getCollectList.xsp?type=2&pageSize=2&pageNo=2 **说明** >根据类型获取收藏列表 **缓存时间** >0 **提交方式** >GET **是否需要登录** >是 **数据来源** > 整形库编辑后台 **参数** ||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| ||pageNo||页数||int||1||是|| ||pageSize||页面大小||int||3||是|| ||type||类型:1:活动,2:案例|| int ||1(默认是1,只取其中之一)||是|| ||common_session_id|| || || ||是|| **返回** {{{#!java { status:0, msg:”请求成功”, pageNo: 1, pageSize: 20, total: 100, data:{ activitiesList:[{ activitiesID:””, title:””, typeName:””, imageUrl””, price:999, discountPrice:1, businessName:”深圳广济医疗美容医院”, doctor:”陈柯”, beginTime:””, buyTotal:100, state:1, surplusTotal:1, status:1 total:0 }], //////////////////////////////////////////////////////按类型的不同,取不同的结果 exampleList:[{ title:”变美过程全记录”, desc:””, imageUrl:”http://img.pconline.com.cn/7.jpg, http://img.pconline.com.cn/7.jpg, http://img.pconline.com.cn/7.jpg”, username:”小美”, time:”2015-01-14”, essence:1, status:1 publicationPhoto:1, exampleID:”” }] } } }}} **返回参数说明** ||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=|| ||= surplusTotal =||=剩余数量=||=total =||=库存(surplusTotal=0&total=0不限购,surplusTotal=0&total!=0已售空)=||