[[TOC]]

= 医美2.2.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/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：活动从多到少||
||curCity||是否当前城市||int||""||否||1：当前城市，如果定位成功且没选择城市时需要传些参数，如果当前城市没数据，返回全部城市的数据||

**返回**

{{{#!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 =||= 活动数=||


=== 1.2启动页 （新增）=== 
开发环境：http://dev15.pclady.com.cn/app/startPage.jsp  [[BR]]
线上环境：http://plastic.pclady.com.cn/app/startPage.jsp [[BR]]
mrobot地址： http://mrobot.pclady.com.cn/s-900/yimei/org/startPage.xsp

**说明**

>启动页

**缓存时间**

>15分钟

**提交方式**

>GET

**数据来源**

> 整形库

**修改内容**

> 

**参数**

||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||=说明=||

**返回**

{{{#!java
{
    "type": 1,
    "imageUrl": "http: //img.pconline.com.cn/7.jpg",
     "url": "",
     "contentID": 14324,
     "circleContentID": 123,
     "circleContentType":1
}

}}}
**返回参数说明**
[http://rdtrac.pc.com.cn/iphone/wiki/yimei_wap_url "参考首页配置"]


== 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":"",
       "commentCount":1,
      "laudCount":1
    },
    "post":{
       "contentID":132,
       "title":"",
       "imageUrl":"",
       "time":"",
       "commentCount":1,
      "laudCount":1
    },
    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/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.2.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.2.0时，需要返回日记和案例||


**返回**

{{{#!java
{
    "status": 0,
    "msg": "请求成功",
    "pageNo": 1,
    "pageSize": 20,
    "total": 100,
    " data": [
        {
            "contentID": "",
            "type": 1,
            "title": "",
            "desc": "",
            "imageUrl": [
                "",
                "",
                ""
            ],
            " username": "小美",
            "time": "2015-01-24",
            "userTypeImage":["",""],
            " essence": 1,
            "publicationPhoto": 1
        }
    ]
}

}}}

**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||
||= contentID =||=案例ID或日记ID=||= type =||= 类型：1：日记，2：案例=||
||= title =||=标题=||= desc =||= 描述=||
||= imageUrl =||=图片=||= username =||= 昵称=||
||= essence =||=是否精华：1：是，0：否=||= publicationPhoto =||= 是否晒单：1：是，0：否=||
||= time =||=发布时间=||= userTypeImage=||=达人图杜地址,支持返回多个图片 =||

== 5.医院 ==
----------
=== 5.1医院主页（修改） ===

开发环境：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

**数据来源**

> 整形库编辑后台
**修改内容**

> 1：详见框架 [[BR]]

**参数**

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

**返回**

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

}}}

**返回参数说明**
||= 参数名 =||= 参数含义 =||=参数名=||=参数含意=||