wiki:yimei1.0.0_api

Version 191 (modified by caomenglin, 11 years ago) (diff)

--

Table of Contents

  1. CMS终端页地址
  2. 1.CMS
    1. 1.1引导页项目列表(CMS)
    2. 1.2焦点图(CMS)
    3. 1.3特色展示(CMS)
    4. 1.4活动专场(CMS)
    5. 1.5城市列表(CMS)
  3. 2.用户
    1. 2.1新增用户
    2. 2.2提交感兴趣的项目
    3. 2.3分享好友
  4. 3.首页
    1. 3.1首页数据接口
    2. 3.2获取专场列表
    3. 3.3获取专场详情
  5. 4.活动
    1. 4.1获取优惠活动列表
    2. 4.2获取活动详情(web页)
  6. 5.案例
    1. 5.1获取案例列表
    2. 5.2获取晒单/案例详细信息(web页)
  7. 6.医院
    1. 6.1医院主页（web）
    2. 6.2获取医院详细信息(web页)
  8. 7.医生
    1. 7.1获取医生列表
    2. 7.2医生主页
    3. 7.3获取医生详细信息(web页)
  9. 8.获取部位和项目列表
  10. 9.订单
    1. 9.1提交订单
    2. 9.2获取用户订单
    3. 9.3获取订单详情
    4. 9.4取消用户订单
    5. 9.5获取用户消费密码
    6. 9.6创建微信订单
    7. 9.7支付结果提交
    8. 9.8获取未支付订单数量
    9. 9.9抢购接口
  11. 10.积分
    1. 10.1获取用户积分
  12. 10.2获取历史积分
  13. 11.用户信息
    1. 11.1获取用户资料
    2. 11.2完善用户资料
    3. 11.3签到
  14. 12.获取标签列表 == （V1.0.0不需提供）
  15. 13.晒单
    1. 13.1发表晒单 ===（V1.0.0不需提供）
  16. 14.项目介绍
    1. 14.1获取项目介绍信息 (web页)
  17. 15.意见反馈 /版本更新
  18. 16.登录/注册/重置密码/修改密码
  19. ---------1.1.0接口---------
    1. 2.3分享好友
  20. 12.用户收藏
    1. 12.1收藏/取消收藏 ===（V1.1.0）
    2. 12.2获取收藏列表 ===（V1.1.0）

医美1.0.0接口文档

mrobot代理环境说明：

192.168.10.198：1080(192.168.74.80)
192.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）
ps:未到qa阶段，连开发环境调试（若仅做代理，mrobot不存在真正的处理文件，只作转发的功能）

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/
 http://www1.pclady.com.cn/zt/wap/gz20150324/ymapp/css/ymapp.css

1.CMS

1.1引导页项目列表(CMS)

（接口已完成，使用请连开发机代理）
CMS地址：  http://plastic.pclady.com.cn/ym2015/nq/1503/intf7167.js
mrobot地址：  http://mrobot.pclady.com.cn/x-86400-g2u/yimei-cms/ym2015/nq/1503/intf7167.js

说明

获取引导页中的项目, ID对应整形库中的，但名称可能不一样。

缓存时间

24小时

提交方式

GET

数据来源

CMS

参数

参数名 参数含义 类型 默认值 是否必须

返回 

{
  "status":0,
  "msg":”请求成功”,
  "data":[{
    typeID:"1",
    name:”眼部”
   }]
}

1.2焦点图(CMS)

（接口已完成，使用请连开发机代理）
CMS地址：  http://plastic.pclady.com.cn/ym2015/nq/1503/intf7187.js
mrobot地址： http://mrobot.pclady.com.cn/x-900-g2u/yimei-cms/ym2015/nq/1503/intf7187.js

说明

获取焦点图,最多5张

缓存时间

15分钟

提交方式

GET

数据来源

CMS

参数

参数名 参数含义 类型 默认值 是否必须

返回 

{
  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)

（接口已完成，使用请连开发机代理）
CMS地址：  http://plastic.pclady.com.cn/ym2015/nq/1503/intf7207.js
mrobot地址:  http://mrobot.pclady.com.cn/x-900-g2u/yimei-cms/ym2015/nq/1503/intf7207.js

说明

获取特色展示,2条

缓存时间

15分钟

提交方式

GET

数据来源

CMS

参数

参数名 参数含义 类型 默认值 是否必须

返回 

{
  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)

（接口已完成，使用请连开发机代理）
CMS地址：  http://plastic.pclady.com.cn/ym2015/nq/1503/intf7208.js
mrobot地址： http://mrobot.pclady.com.cn/x-900-g2u/yimei-cms/ym2015/nq/1503/intf7208.js

说明

获取活动专场,3条

缓存时间

15分钟

提交方式

GET

数据来源

CMS

参数

参数名 参数含义 类型 默认值 是否必须

返回 

{
  status:0,
  msg:”请求成功”,
  data: [{
      title:”新年美肤专场，水嫩肌肤换出来”,
      imageUrl:”http://img.pconline.com.cn/7.jpg”,
      specialID:”14242”
    }]
}

返回参数说明

参数名 参数含义
specialID 专场ID

1.5城市列表(CMS)

（接口已完成，使用请连开发机代理）
CMS地址：  http://plastic.pclady.com.cn/ym2015/nq/1503/intf7227.js
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

说明

获取活动专场,3条

缓存时间

24小时

提交方式

GET

数据来源

CMS

参数

参数名 参数含义 类型 默认值 是否必须

返回 

{
  "status":0,
  "msg":"请求成功",
  "data": [“北京”,”上海”,”广州”]
}

2.用户

2.1新增用户

开发环境： http://dev15.pclady.com.cn/app/addUser.jsp
线上环境： http://plastic.pclady.com.cn/app/addUser.jsp

说明

注册成功后，通知平台添加用户和积分

缓存时间

0

提交方式

POST

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
r时间截String""是
signMD5加密串String""是

返回 

{
  status:0,
  msg:”请求成功”
}

2.2提交感兴趣的项目

开发环境： http://dev15.pclady.com.cn/app/addLikeProject.jsp
线上环境： http://plastic.pclady.com.cn/app/addLikeProject.jsp

说明

用于提交引导页中感兴趣的项目，卸载APP后再次提交时，覆盖添加

缓存时间

0

提交方式

POST

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须 说明
age年龄段String""否
project项目列表String""否列表

返回 

{
  status:0,
  msg:”请求成功”
}

2.3分享好友

开发环境： http://dev15.pclady.com.cn/app/shareFriend.jsp
线上环境： http://plastic.pclady.com.cn/app/shareFriend.jsp

说明

分享好友，辊积分

缓存时间

0

提交方式

GET

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须 说明
userId用户IDString""否

返回

后期会做一个分享的界面，请求时只是在参数中加一个用户ID

3.首页

3.1首页数据接口

（接口已完成，使用请连开发机代理）
开发环境： http://dev15.pclady.com.cn/app/index.jsp
线上环境： http://plastic.pclady.com.cn/app/index.jsp
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""否

返回 

{
  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获取专场列表

（接口已完成，使用请连开发机代理）
开发环境： http://dev15.pclady.com.cn/app/getSpecialList.jsp
线上环境： http://plastic.pclady.com.cn/app/getSpecialList.jsp
mrobot地址：  http://mrobot.pclady.com.cn/x-900/yimei-plastic/app/getSpecialList.jsp

说明

获取专场列表

缓存时间

15分钟

提交方式

GET

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
pageNo页数int1是
pageSize页面大小int4是

返回 

{
  status:0,
  msg:”请求成功”,
  pageNo: 1, 
  pageSize: 20,
  total: 100,
  data:[{
    title:"陈柯",
    specialID:””, 
    city:”广州,深圳,北京”, 
    discount:””,
    buyTotal:12,
    imageUrl:""
   }]
}

返回参数说明

参数名 参数含义 参数名参数含意
discount 折扣 buyTotal 预售销量

3.3获取专场详情

（接口已完成，使用请连开发机代理）
开发环境： http://dev15.pclady.com.cn/app/getSpecial.jsp
线上环境： http://plastic.pclady.com.cn/app/getSpecial.jsp
mrobot地址：  http://mrobot.pclady.com.cn/x-900/yimei-plastic/app/getSpecial.jsp

说明

获取专场列表

缓存时间

15分钟

提交方式

GET

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
pageNo页数int1是
pageSize页面大小int4是
specialID 专场IDString””是

返回 

{
  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获取优惠活动列表

（接口已完成，使用请连开发机代理）
开发环境： http://dev15.pclady.com.cn/app/getDiscountActivitiesList.jsp
线上环境： http://plastic.pclady.com.cn/app/getDiscountActivitiesList.jsp
mrobot：  http://mrobot.pclady.com.cn/x/yimei-plastic/app/getDiscountActivitiesList.jsp

说明

获取优惠活动列表

缓存时间

0

提交方式

GET

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须 说明
pageNo页数int1是
pageSize页面大小int10是
project 项目String""否项目ID，过滤的项目
age年龄段int""否
city城市String""否过滤时用到的城市
locationCity城市String""否用户所在城市
specialID专场String""否专场ID
order排序String""否排序规则1：销量，2：价格，默认为空
businessID商家String""否从医院进入更多界面时需要根据商家ID请求
buyOther购买了该活动的用户还购买了其它的。String"1"否传1表示需要过滤
activityID活动IDString""否buyOther用到时需要传
bFilter是否是过滤查询String"1"否传1时表示过滤查询
secKill过滤秒杀活动String"1"否传1时表示只查询秒杀的活动，不传时不做处理

过滤时city、project、order都可以不为空，组合查询。但其它参数不需要传 buyother不为空时还需要要传个活动ID

返回 

{
  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页)

（接口已完成，使用请连开发机代理）
开发环境：  http://dev15.pclady.com.cn/app/getActivitesInfo.jsp
线上环境：  http://plastic.pclady.com.cn/app/getActivitesInfo.jsp
mrobot：  http://mrobot.pclady.com.cn/x/yimei-plastic/app/getActivitesInfo.jsp

说明

获取活动详情

缓存时间

0

提交方式

GET

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
activitiesID活动String""是
appVersion版本号String""否
showDownload显示下文的下载栏,1:显示，没传此参数时就不显示String""是

返回 

{
  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获取案例列表

（接口已完成，使用请连开发机代理）
开发环境： http://dev15.pclady.com.cn/app/getExampleList.jsp
线上环境： http://plastic.pclady.com.cn/app/getExampleList.jsp
mrobot环境： http://mrobot.pclady.com.cn/x-900/yimei-plastic/app/getExampleList.jsp

说明

获取案例列表

缓存时间

15分钟

提交方式

GET

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须 说明
pageNo页数int1是
pageSize页面大小int3是
age年龄段int""否
positionID部位IDString""否部位，一级分类ID、感兴趣ID
subPositionID部位IDString""否功效，二级分类ID
projectID项目IDString""否三级分类ID
doctorID医生IDString""否医生主页中会根据医生来获取案例
businessID医院IDString""否医院主页中会根据医院来获取案例
city城市String""否首页查询时用到
activityID活动IDString""否活动详情页用到

返回 

{
  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页)

（接口已完成，使用请连开发机代理）
开发环境： http://dev15.pclady.com.cn/app/getExampleInfo.jsp
线上环境： http://plastic.pclady.com.cn/app/getExampleInfo.jsp
mrobot：  http://mrobot.pclady.com.cn/x-3600/yimei-plastic/app/getExampleInfo.jsp

说明

获取案例详情信息，返回的标签点击后要做处理

缓存时间

1小时

提交方式

GET

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
exampleID案例IDString""是
showDownload显示下文的下载栏,1:显示，没传此参数时就不显示String""是

返回 

{
  status:0,
  msg:”请求成功”,
  data:[{ 
    exampleID:””, 
    title:”案例标题”, 
    desc:”案例描述”, 
    imageUrl:案例图片地址, 
    hasCollect:1
    }
  ]
}

6.医院

6.1医院主页（web）

开发环境： http://dev15.pclady.com.cn/app/getBusiness.jsp
线上环境： http://plastic.pclady.com.cn/app/getBusiness.jsp
mrobot：  http://mrobot.pclady.com.cn/x-3600/yimei-plastic/app/getBusiness.jsp

说明

获取商家信息

缓存时间

1小时

提交方式

GET

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
businessID商家 String ""是

返回 

{
  status:0,
  msg:”请求成功”,
  html:""
}

返回参数说明

参数名 参数含义 参数名参数含意

6.2获取医院详细信息(web页)

开发环境： http://dev15.pclady.com.cn/app/getBusinessInfo.jsp
线上环境： http://plastic.pclady.com.cn/app/getBusinessInfo.jsp
mrobot：  http://mrobot.pclady.com.cn/x-3600/yimei-plastic/app/getBusinessInfo.jsp

说明

获取医院详细信息

缓存时间

1小时

提交方式

GET

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
businessID 活动String""是

返回 

{
  status:0,
  msg:”请求成功”,
  data:{
    html:""
  }
}

7.医生

7.1获取医生列表

开发环境： http://dev15.pclady.com.cn/app/getDoctorList.jsp
线上环境： http://plastic.pclady.com.cn/app/getDoctorList.jsp
mrobot环境： http://mrobot.pclady.com.cn/x-900/yimei-plastic/app/getDoctorList.jsp

说明

根据医院信息获取医生列表

缓存时间

15分钟

提交方式

GET

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
pageNo页数int1是
pageSize页面大小int3是
businessID医院String""是

返回 

{
  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
线上环境： http://plastic.pclady.com.cn/app/getDoctor.jsp
mrobot环境： http://mrobot.pclady.com.cn/x-3600/yimei-plastic/app/getDoctor.jsp

说明

获取商家信息

缓存时间

1小时

提交方式

GET

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
doctorID医生 String ""是

返回 

{
  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
线上环境： http://plastic.pclady.com.cn/app/getDoctorInfo.jsp
mrobot:  http://mrobot.pclady.com.cn/x-3600/yimei-plastic/app/getDoctorInfo.jsp

说明

获取医生详细信息

缓存时间

1小时

提交方式

GET

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
doctorID 医生IDString""是

返回 

{
  status:0,
  msg:”请求成功”,
  data:{
    html:""
  }
}

8.获取部位和项目列表

开发环境： http://dev15.pclady.com.cn/app/getProjectList.jsp
线上环境： http://plastic.pclady.com.cn/app/getProjectList.jsp
mrobot环境： http://mrobot.pclady.com.cn/x-86400/yimei-plastic/app/getProjectList.jsp

说明

获取部位，项目

缓存时间

24小时

提交方式

GET

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须

返回 

{
  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
线上环境： http://plastic.pclady.com.cn/app/createOrder.jsp

说明

抢购后生成订单

缓存时间

0

提交方式

POST

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
activitiesID活动String""是
total购买数量 int ""是
phone手机号String""是
useScore兑换的积分String""是
contacts联系人String""是
appVersion版本号1.1.0加入的，区分1.0.0中没有联系人String""是
r时间截String""是
signMD5加密串String""是

返回 

{
  status:0,
  msg:”请求成功”,
  orderID:"12424234234",
  orderNO:"流水号ID",
  password:"消费密码，金额为0时，直接购买成功，返回消费密码"
}

9.2获取用户订单

开发环境： http://dev15.pclady.com.cn/app/getUserOrderList.jsp
线上环境： http://plastic.pclady.com.cn/app/getUserOrderList.jsp
mrobot地址：  http://mrobot.pclady.com.cn/x/yimei-plastic/app/getUserOrderList.jsp

说明

获取我的订单

缓存时间

0

提交方式

GET

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
pageNo页数int1是
pageSize页面大小int4是
orderType 订单类型1:全部，2：未消费，3：已消费，4：待付款int""是
r时间截String""是
signMD5加密串String""是

返回 

{
  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消费最后期限state1：待付款，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
线上环境： http://plastic.pclady.com.cn/app/getOrderInfo.jsp
mrobot：  http://mrobot.pclady.com.cn/x/yimei-plastic/app/getOrderInfo.jsp

说明

获取订单详情

缓存时间

0

提交方式

GET

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
orderID 订单int""是
r时间截String""是
signMD5加密串String""是

返回 

{
  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
线上环境： http://plastic.pclady.com.cn/app/cancelOrder.jsp
mrobot：  http://mrobot.pclady.com.cn/x/yimei-plastic/app/cancelOrder.jsp

说明

取消订单

缓存时间

0

提交方式

GET

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
orderID 订单String""是
r时间截String""是
signMD5加密串String""是

返回 

{
  status:0,
  msg:”请求成功”
}

9.5获取用户消费密码

开发环境： http://dev15.pclady.com.cn/app/getUsePassword.jsp
线上环境： http://plastic.pclady.com.cn/app/getUsePassword.jsp
mrobot：  http://mrobot.pclady.com.cn/x/yimei-plastic/app/getUsePassword.jsp

说明

支付成功后获取用户的消费密码

缓存时间

0

提交方式

GET

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
orderID 订单string""是
r时间截String""是
signMD5加密串String""是

返回 

{
  status:0,
  msg:”请求成功”,
  data:{
    password:[123456,123124,432423]

  }
}

返回参数说明

参数名 参数含义 参数名参数含意
score 奖励的积分 password 消费密码

9.6创建微信订单

开发环境： http://dev15.pclady.com.cn/app/createWechatOrder.jsp
线上环境： http://plastic.pclady.com.cn/app/createWechatOrder.jsp

说明

生成微信订单

缓存时间

0

提交方式

POST

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
orderNO 流水号IDString""是
r时间截String""是
signMD5加密串String""是

返回 

{
  status:0,
  msg:”请求成功”,
  timestamp:"时间戳",
  appid:"应用ID",
  partnerid:"商户ID",
 prepayid:"预支付订单",
 noncestr:"随机串",
 package:"商家根据财付通文档填写的数据和签名",
 sign:"签名"
}

9.7支付结果提交

开发环境： http://dev15.pclady.com.cn/app/submitPayResult.jsp
线上环境： http://plastic.pclady.com.cn/app/submitPayResult.jsp

说明

抢购后生成订单

缓存时间

0

提交方式

POST

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
orderNO 流水号IDString""是
payTime 支付时间：yyyyMMddhhmmssString""是
payStatus支付状态,支付返回的状态0:成功，-1:失败,-2：取消String""是
payType支付类型 1=支付宝，2=微信String""是
payMessage 支付信息，支付结果信息，如支付成功，取消支付，支付失败String""是
r时间截String""是
signMD5加密串String""是

返回 

{
  status:0,
  msg:”请求成功”,
}

9.8获取未支付订单数量

开发环境： http://dev15.pclady.com.cn/app/getNoPayTotal.jsp
线上环境： http://plastic.pclady.com.cn/app/getNoPayTotal.jsp

说明

抢购后生成订单

缓存时间

0

提交方式

POST

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
r时间截String""是
signMD5加密串String""是

返回 

{
  status:0,
  msg:”请求成功”,
  total:"",
  hasSignIn:1
}

返回参数说明

参数名 参数含义 参数名参数含意
total 未付款数量 hasSignIn 是否签到，1：已签到，0：未签到

9.9抢购接口

开发环境： http://dev15.pclady.com.cn/app/quickBuy.jsp
线上环境： http://plastic.pclady.com.cn/app/quickBuy.jsp

说明

抢购后生成订单

缓存时间

0

提交方式

POST

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
activityID 活动IDString""是
r时间截String""是
signMD5加密串String""是

返回 

{
  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
线上环境： http://plastic.pclady.com.cn/app/getUserScore.jsp
mrobot地址：  http://mrobot.pclady.com.cn/x/yimei-plastic/app/getUserScore.jsp

说明

获取用户积分

缓存时间

0

提交方式

GET

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须

返回 

{
  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
线上环境： http://plastic.pclady.com.cn/app/getUserScoreList.jsp
mrobot地址：  http://mrobot.pclady.com.cn/x/yimei-plastic/app/getUserScoreList.jsp

说明

获取用户历史积分

缓存时间

0

提交方式

GET

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
pageNo页数int1是
pageSize页面大小int4是

返回 

{
  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
线上环境： http://plastic.pclady.com.cn/app/getUserInfo.jsp
mrobot地址：  http://mrobot.pclady.com.cn/x/yimei-plastic/app/getUserInfo.jsp

说明

获取用户的资料

缓存时间

0

提交方式

GET

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须

返回 

{
  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
线上环境： http://plastic.pclady.com.cn/app/updateUserInfo.jsp

说明

完善用户资料

缓存时间

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""是

返回 

{
  status:0,
  msg:”请求成功”
}

11.3签到

开发环境： http://dev15.pclady.com.cn/app/getMyScore.jsp
线上环境： http://plastic.pclady.com.cn/app/getMyScore.jsp

说明

签到

缓存时间

0

提交方式

POST

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
r时间截String""是
signMD5加密串String""是

返回 

{
  status:0,
  msg:”请求成功”,
  score:115
}

返回参数说明

参数名 参数含义
score 用户总积分

12.获取标签列表 == （V1.0.0不需提供）

getLabelList

说明

根据活动获取标签,标签读取该活动归属的项目二级分类下的所有项目名称

缓存时间

15分钟

提交方式

GET

数据来源

提交给整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
activitiesID活动ID String ""是

返回 

{
  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 ""否

返回 

{
  status:0,
  msg:”请求成功”
}

14.项目介绍

14.1获取项目介绍信息 (web页)

开发环境： http://dev15.pclady.com.cn/app/getProjectInfo.jsp
线上环境： http://plastic.pclady.com.cn/app/getProjectInfo.jsp
mrobot：  http://mrobot.pclady.com.cn/x-3600/yimei-plastic/app/getProjectInfo.jsp

说明

获取案例列表

缓存时间

1小时

提交方式

GET

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
projectID项目IDString""是
locationCity定位城市String""否

返回 

{
  status:0,
  msg:”请求成功”,
  data:{ 
    html:””
    }
}

15.意见反馈 /版本更新

说明

调用魔方

16.登录/注册/重置密码/修改密码

说明

调用passport

---------1.1.0接口---------

2.3分享好友

开发环境： http://dev15.pclady.com.cn/app/shareFriend.jsp
线上环境： http://plastic.pclady.com.cn/app/shareFriend.jsp

说明

分享好友，加积分

缓存时间

0

提交方式

POST

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
r时间截String""是
signMD5加密串String""是

返回 

{
  status:0,
  msg:”请求成功”
}

12.用户收藏

12.1收藏/取消收藏 ===（V1.1.0）

开发环境： http://dev15.pclady.com.cn/app/collectForApp.jsp
线上环境： http://plastic.pclady.com.cn/app/collectForApp.jsp

collectForApp

说明

用于添加收藏和取消收藏

缓存时间

0

提交方式

POST

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
typeID类型ID，分别为活动ID、案例ID String ""是
type类型：1：活动，2：案例 int ""是
operation操作：1：收藏，2：取消收藏 int ""是

返回 

{
  status:0,
  msg:”请求成功”
}

12.2获取收藏列表 ===（V1.1.0）

*mrobot已完成，可连开机机进行测试 *

开发环境： http://dev15.pclady.com.cn/app/getCollectList.jsp
线上环境： http://plastic.pclady.com.cn/app/getCollectList.jsp
mrobot环境接口

 http://mrobot.pclady.com.cn/s/yimei/my/getCollectList.xsp?type=2&pageSize=2&pageNo=2

说明

根据类型获取收藏列表

缓存时间

0

提交方式

GET

是否需要登录

是

数据来源

整形库编辑后台

参数

参数名 参数含义 类型 默认值 是否必须
pageNo页数int1是
pageSize页面大小int3是
type类型：1：活动，2：案例 int 1(默认是1，只取其中之一)是
common_session_id 是

返回 

{
  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已售空）

Attachments