[[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


== 1.首页 ==
----------
=== 1.1精选机构 （修改）=== 
开发环境：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 =||= 有机构的城市，过滤查询时用到 =||=activityTotal =||= 活动数=||


=== 1.2帖子精选 ===
开发环境：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 =||=图片地址=||
||= type =||= 1：日记，2：帖子=||= imageUrl =||=推荐图=||
||= message =||= 帮主说两句=||= =||==||


=== 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：返回参数中一级项目添加subTitle、imageUrl,type [[BR]]

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||
||= appVersion =||= 版本号 =||= int =||= "" =||= 否 =||版本号去掉.如2.1.0->210||

**返回**

{{{#!java
{
    "status": 0,
    "msg": "请求成功",
    "total": 11,
    "data": [
        {
            "typeID": "1",
            "name": "一级部位",
            "subTitle": "我是小标题",
            "imageUrl": "",
            "type":1,
            "item": [
                {
                    "typeID": "101",
                    "name": "二级部位",
                    "item": [
                        {
                            "typeID": "201",
                            "name": "项目名称"
                        }
                    ]
                }
            ]
        }
    ]
}

}}}

**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= typeID =||= 类型ID=||= name =||=部位名称=||
||= subTitle =||= 热点项目的二级标题=||= 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": "",
            "isVip": 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 =||=医院科室=||
||= isVip =||= 医院是否认证=||=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.达人标识 ==
----------
=== 3.1添加达人标识(修改) ===
圈子相关接口返回时添加达人标识（userType），需要修改的接口如下 [[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：医生=||= guideImageUrl =||= 专场介绍图=||