wiki:yimei2.2.0_api

Context Navigation

Version 10 (modified by caomenglin, 10 years ago) (diff)
--

医美2.2.0接口文档

mrobot代理环境说明：

192.168.10.198：1080(192.168.74.80)
192.168.10.199 端口为 1080 连的是dev40的开发环境（192.168.75.40）
ps:未到qa阶段，连开发环境调试（若仅做代理，mrobot不存在真正的处理文件，只作转发的功能）
制作地址： 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/
bip接口地址： http://trac.pc.com.cn/bip/wiki/sysnotice
终端协议： http://rdtrac.pc.com.cn/iphone/wiki/yimei_wap_url

1.首页

1.1精选机构（修改）

开发环境： http://dev15.pclady.com.cn/app/indexOrgList.jsp
线上环境： http://plastic.pclady.com.cn/app/indexOrgList.jsp
mrobot地址： http://mrobot.pclady.com.cn/s-900/yimei/org/indexOrgList.xsp?pageNo=1&pageSize=10

说明

从首页入口进入的精选机构列表

缓存时间

15分钟

提交方式

GET

数据来源

整形库

修改内容

1：请求参数添加order和city字段，用于过滤查询

2：返回参数添加city节点，用于获取有机构的城市，返回格式为数组
3：返回参数添加activityTotal，优惠活动总数

参数

参数名	参数含义	类型	默认值	是否必须	说明
pageNo	页数	int	1	是
pageSize	页面大小	int	10	是
city	城市名	String	""	否
order	排序	int	""	否	1：默认排序，2：星级从高到低，3：活动从多到少
curCity	是否当前城市	int	""	否	1：当前城市，如果定位成功且没选择城市时需要传些参数，如果当前城市没数据，返回全部城市的数据

{
    "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
线上环境： http://plastic.pclady.com.cn/app/startPage.jsp
mrobot地址： http://mrobot.pclady.com.cn/s-900/yimei/org/startPage.xsp

说明

启动页

缓存时间

15分钟

提交方式

GET

数据来源

整形库

修改内容

参数

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

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

返回参数说明 参考首页配置

2.帖子

2.1帖子详情页(修改)

(mrobot已完成，请连开发机进行测试)
开发环境： http://dev15.pclady.com.cn/app/postInfo.jsp

http://dev15.pclady.com.cn/app/commentList.jsp

线上环境： http://plastic.pclady.com.cn/app/postInfo.jsp

http://plastic.pclady.com.cn/app/commentList.jsp

mrobot地址： http://mrobot.pclady.com.cn/s/yimei/circle/topic.xsp

说明

帖子终端页，应用端只需要出数据，wap页由mrobot来完成。

缓存时间

0分钟

提交方式

GET

是否登录

查询收藏状态时需要登录，其它情况不需要登录

数据来源

整形库编辑后台

修改内容

1：返回时添加活动、日记、帖子、医院、医生、项目,点击头像等节点（project、userHead、doctor、hospital、post、diary、activity）

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，去掉小数点"	否

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

说明

回复

缓存时间

0分钟

提交方式

POST

是否登录

是

数据来源

整形库编辑后台

修改

1：请求添加三个参数imageUrl、diaryID，postID

参数

参数名	参数含义	类型	默认值	是否必须	说明
contentID	文章ID	string	""	是
contentType	文章类型	string	""	是	1：日记，2：帖子
replyID	回复ID	string	""	否	直接评论日记或帖子时，不需要传
replySecondID	回复二级ID	string	""	否	=直接评论日记或帖子时，不需要传
replyContent	回复内容	string	""	是	回复内容
imageUrl	图片	string	""	否	图片地址
diaryID	日记ID	string	""	否	插入日记
postID	帖子ID	string	""	否	插入帖子

{
  "status":0,
  "msg":"请求成功"
  "Integral":1
}

返回参数说明

参数名	参数含义	参数名	参数含意
Integral	奖励积分

3.2评论列表（修改）

(mrobot已完成，请连开发机进行测试)
开发环境： http://dev15.pclady.com.cn/app/commentList.jsp?contentID=1&contentType=1
线上环境： http://plastic.pclady.com.cn/app/commentList.jsp
mrobot地址： http://mrobot.pclady.com.cn/s/yimei/circle/commentList.xsp

说明

获取评论列表

缓存时间

0分钟

提交方式

GET

是否登录

否

数据来源

整形库编辑后台

修改

1：返回时添加imageUrl参数、diary节点，post节点

参数

参数名	参数含义	类型	默认值	是否必须	说明
pageNo	页数	int	1	是
pageSize	页面大小	int	10	是
contentID	文章ID	string	""	是
contentType	文章类型	string	""	是	1：日记，2：帖子

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

说明

获取案例列表

缓存时间

15分钟

提交方式

GET

数据来源

整形库编辑后台

修改内容

1：请求参数添加appVersion，版本号大于等于2.2.0需要返回日记和案例

参数

参数名	参数含义	类型	默认值	是否必须	说明
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时，需要返回日记和案例

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

说明

获取商家信息

缓存时间

1小时

提交方式

GET

数据来源

整形库编辑后台

修改内容

1：详见框架

参数

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

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

返回参数说明

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

Download in other formats:

Plain Text

Context Navigation

Table of Contents

医美2.2.0接口文档

1.首页

1.1精选机构 （修改）

1.2启动页 （新增）

2.帖子

2.1帖子详情页(修改)

3评论

3.1回复评论（修改）

3.2评论列表（修改）

4.案例

4.1获取案例列表（修改）

5.医院

5.1医院主页（修改）

Download in other formats:

1.1精选机构（修改）

1.2启动页（新增）