Table of Contents
医美2.1.0接口文档
请求添加用户ID的接口
参数为userId = xxx
getUserScore.jsp 用户积分
getUserScoreList.jsp 用户积分
getUserInfo.jsp 用户信息
myDiaryList.xsp 我的日记
myPostList.xsp 我的帖子
getUserOrderList.jsp 用户订单
getOrderInfo.jsp 订单信息
getCollectList.xsp 收藏列表
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
终端协议
制作修改
具体修改到时看设计稿
项目详情页
现有活动栏目名应为“本项目相关活动”,另外调整该栏目样式,增加活动图片、商家名称、抢购人数/即将开始标识,样式同医院主页活动列表页
活动详情页
购买须知部分增加文字样式,此为后台编辑框需求,需要设计,字段如下: 消费有效期: 预约提醒: 支付与退款: 使用规则: 服务承诺: 联系客服:
医院主页
医院主页添加图片展示
日记终端页
具体修改内容参照设计稿和需求文档
帖子终端页
具体修改内容参照设计稿和需求文档
1.首页
1.1帖子精选
(mrobot已完成开发,请连开发机进行测试)
开发环境: http://dev15.pclady.com.cn/app/essencePostList.jsp
线上环境: http://plastic.pclady.com.cn/app/essencePostList.jsp
mrobot地址: http://mrobot.pclady.com.cn/s-900/yimei/cms/essencePostList.xsp
说明
获取帖子精选
缓存时间
15分钟
提交方式
GET
是否登录
否
数据来源
整形库编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| pageNo | 页数 | int | 1 | 是 | |
| pageSize | 页面大小 | int | 10 | 是 |
返回
{
"status": 0,
"msg": "请求成功",
"pageNo": 1,
"pageSize": 20,
"total": 100,
"data": [
{
"cornerType": "角标",
"imageUrl": "",
"title": "",
"message": "",
"contentID": 111
}
]
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| contentID | 内容ID | title | 标题 |
| cornerType | 角标 | imageUrl | 图片地址 |
| message | 帮主说两句 |
1.2帖子精选详情页
(mrobot已完成开发,请连开发机进行测试)
开发环境: http://dev15.pclady.com.cn/app/essencePostInfoList.jsp
线上环境: http://plastic.pclady.com.cn/app/essencePostInfoList.jsp
mrobot地址: http://mrobot.pclady.com.cn/s-900/yimei/cms/essencePostInfoList.xsp
说明
获取帖子精选详情页
缓存时间
15分钟
提交方式
GET
是否登录
否
数据来源
整形库编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| pageNo | 页数 | int | 1 | 是 | |
| pageSize | 页面大小 | int | 10 | 是 | |
| contentID | 帖子精选ID | int | 是 |
返回
{
"status": 0,
"msg": "请求成功",
"pageNo": 1,
"pageSize": 20,
"total": 100,
"sysTime":"",
"data":[{
"contentID":"帖子ID",
"nickName":"",
"userID":"",
"imageUrl":"",
"title":"",
"commentCount":1,
"laudCount":1,
"dateTime":"刚刚",
"isessence":1,
"ispublicationPhoto":1,
"userTypeImage":["",""]
}
],
"article":[
{
"title":"标题",
"url":""
}
]
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| article | 文章节点 | title | 标题 |
| url | 文章地址 | data | 帖子节点,字段名称请查看2.0的圈子列表 |
1.3.获取项目列表(修改)
(客户端调用原接口,直接添加参数即可)
开发环境: 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
数据来源
整形库编辑后台
修改内容
1:请求参数添加appVersion,版本号大于等于2.1.0时才返回热点项目,默认返回6条
2:返回参数添加hot节点
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| appVersion | 版本号 | int | "" | 否 | 版本号去掉.如2.1.0->210 |
返回
{
"status": 0,
"msg": "请求成功",
"total": 11,
"hot":[
{ "typeId": "项目ID",
"name": "项目名称",
"desc": "我是小标题",
"imageUrl": "",
}
]
"data": [
{
"typeId": "1",
"name": "一级部位",
"item": [
{
"typeId": "101",
"name": "二级部位",
"item": [
{
"typeId": "201",
"name": "项目名称"
}
]
}
]
}
]
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| typeId | 类型ID | name | 部位名称 |
| desc | 热点项目的描述信息 | imageUrl | 热点项目的图片地址 |
1.4首页数据接口(修改)
(客户端调用原接口,直接添加参数即可)
开发环境: 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
说明
修改部分:新增首页入口节点(indexEnter),删除特色展示节点(show),修改活动专场节点(activities)
缓存时间
15分钟
提交方式
GET
数据来源
焦点图:CMS、特色展示:CMS、活动专场:CMS、猜你喜欢:整形库编辑后台、推荐案例:整形库编辑后台,日记/帖子
修改内容
1:如果版本号小于210,indexEnter节点返回固定的JSON,如下
{
"status": 0,
"msg": "请求成功",
"data": [
{
"imageUrl": "从CMS获取第1张",
"title": "精选机构",
"type": 1
},
{
"imageUrl": "从CMS获取第2张",
"title": "人气项目",
"type": 2
},
{
"imageUrl": "从CMS获取第3张",
"title": "今日秒杀",
"type": 3
},
{
"imageUrl": "从CMS获取第4张",
"title": "领积分",
"type": 4
}
]
}
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| city | 城市 | String | "" | 否 |
| project | 感兴趣的项目 | String | "" | 否 |
| age | 年龄段 | int | "" | 否 |
| appVersion | 版本号 | String | "app版本号为x.x.x是,参数 传xxx,去掉小数点" | 否 |
返回
{
"listFocus": {
"status": 0,
"msg": "请求成功",
"data": [
{
"type": 1,
"imageUrl": " http://img.pconline.com.cn/7.jpg",
"url": "",
"contentID": "14324",
"circleContentID": "423"
}
]
},
"indexEnter": {
"status": 0,
"msg": "请求成功",
"data": [
{
"imageUrl": " http://img.pconline.com.cn/7.jpg",
"title": "功能1",
"type":1
},
{
"imageUrl": " http://img.pconline.com.cn/7.jpg",
"title": "功能2",
"type":2
}
]
},
"activities": {
"status": 0,
"msg": "请求成功",
"data": [
{
"type": 1,
"imageUrl": "http: //img.pconline.com.cn/7.jpg",
"url": "",
"contentID": "14324",
"circleContentID": "123"
}
]
},
"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 | 焦点图 | indexEnter | 首页入口 |
| activities | 活动专场 | guessYouLike | 猜你喜欢,字段说明参考活动列表 |
2.搜索
2.1热点查询
(mrobot已完成开发,请连开发机进行测试)
开发环境: http://dev15.pclady.com.cn/app/hotList.jsp
线上环境: http://plastic.pclady.com.cn/app/hotList.jsp
mrobot地址: http://mrobot.pclady.com.cn/s-900/yimei/cms/hotList.xsp
说明
获取搜索中的热点名称,默认为9条
缓存时间
15分钟
提交方式
GET
是否登录
否
数据来源
整形库编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|
返回
{
"status": 0,
"msg": "请求成功",
"hot": [
{
"type": 1,
"name": ""
},
{
"type": 2,
"name": ""
}
]
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| type | 热度分为1-4,热度大小对应不同大小的圆,数量如下:热度1:1个 热度2:2个 热度3:3个 热度4:3个 | name | 名称 |
2.2搜索
(mrobot已完成开发,请连开发机进行测试)
开发环境: http://dev15.pclady.com.cn/app/search.jsp
线上环境: http://plastic.pclady.com.cn/app/search.jsp
mrobot地址: http://mrobot.pclady.com.cn/s-900/yimei/cms/search.xsp
说明
搜索优惠、日记、帖子、医院、医生、项目
缓存时间
15分钟
提交方式
GET
是否登录
否
数据来源
整形库编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| pageNo | 页数 | int | 1 | 是 | |
| pageSize | 页面大小 | int | 10 | 是 | |
| name | 关键字 | String | "" | 是 | |
| type | 类型 | String | "" | 是 | 1:优惠、2:圈子、3:医院、4:医生、5:项目 |
1:当type为空时,优惠活动、日记/帖子、医院返回三条,医生和项目返回4条,pageNo和pageSize不需要传,不需要返回pageNo、pageSize,没数据的节点不需要返回,当查询结果没数据时,返回total==0
2:当type不为空时,需要传pageNo和pageSize,需要返回pageNo、pageSize、total,没数据的节点不需要返回
返回
{
"status": 0,
"msg": "请求成功",
"pageNo": 1,
"pageSize": 20,
"activity":{
"total:1,
"data":[]
},
"circle":{
"total:1,
"sysTime":"系统当前时间YYYY-MM-DD HH:mm:ss",
"data":[{
"contentID":"内容ID",
"nickName":"",
"userID":"",
"type":””,
"imageUrl":"",
"title":"",
"commentCount":1,
"laudCount":1,
"dateTime":"刚刚",
"isessence":1,
"ispublicationPhoto":1,
}]
},
"total":100,
"hospital": [
"total":1
"data": {
"hospitalID": 1,
"name": "医院名称",
"imageUrl": "",
"type": 1,
"department": "美容科"
}
],
"doctor": ["total:1,
"data":[]],
"project": [
"total":1,
"data":
{
"projectID": 201,
"name": "项目名称"
}
]
}
返回参数说明
活动: http://rdtrac.pc.com.cn/iphone/wiki/yimei1.0.0_api#a4.1获取优惠活动列表
圈子: http://rdtrac.pc.com.cn/iphone/wiki/yimei2.0.0_api#a2.2获取圈子内容列表
医生: http://rdtrac.pc.com.cn/iphone/wiki/yimei1.0.0_api#a7.1获取医生列表
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| activity | 活动节点 | circle | 圈子节点,包括日记和帖子 |
| hospital | 医院节点 | doctor | 医生节点 |
| project | 项目节点 | hospitalID | 医院ID |
| imageUrl | 图片地址 | department | 医院资质 |
| type | 0:默认商户,1:普通商户、2:认证商户、3:VIP商户 | projectID | 项目ID |
3.专场
3.1获取专场详情(修改)
(客户端调用原接口,直接添加参数即可)
开发环境: 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
数据来源
整形库编辑后台
修改内容
1:返回参数添加guide节点
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| pageNo | 页数 | int | 1 | 是 |
| pageSize | 页面大小 | int | 4 | 是 |
| specialID | 专场ID | String | ”” | 是 |
返回
{
"status": 0,
"msg": "请求成功",
"pageNo": 1,
"pageSize": 20,
"total": 100,
"guide": {
"guideMessage": "",
"guideImage"[
"imageUrl":"",
"width":100,
"height":200
]
},
"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-->imageUrl | 专场介绍图 |
| guideImageUrl-->width | 图片实际长度 | guideImageUrl-->height | 图片实际高度 |
4.达人标识
4.1添加达人标识(修改)
圈子相关接口返回时添加达人标识(userTypeImage),需要修改的接口如下
精选推荐(已添加): http://rdtrac.pc.com.cn/iphone/wiki/yimei2.0.0_api#a1.1精选推荐
获取圈子内容列表(已添加): http://rdtrac.pc.com.cn/iphone/wiki/yimei2.0.0_api#a2.2获取圈子内容列表
日记详情页: http://rdtrac.pc.com.cn/iphone/wiki/yimei2.0.0_api#a2.4日记详情页WEB页
帖子详情页: http://rdtrac.pc.com.cn/iphone/wiki/yimei2.0.0_api#a2.5帖子详情页WEB页
评论列表(已添加): http://rdtrac.pc.com.cn/iphone/wiki/yimei2.0.0_api#a2.10评论列表
用户主页(已添加): http://rdtrac.pc.com.cn/iphone/wiki/yimei2.0.0_api#a3.1用户主页
获取用户资料(已添加): http://rdtrac.pc.com.cn/iphone/wiki/yimei1.0.0_api#a11.1获取用户资料
收藏列表中的圈子类型(已添加): http://rdtrac.pc.com.cn/iphone/wiki/yimei1.0.0_api#a12.2获取收藏列表V1.1.0
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| userTypeImage | 达人图标地址,支持返回多个图片 |
5.日记/帖子
5.1发日记(修改)
开发环境: http://dev15.pclady.com.cn/app/addDiary.jsp
线上环境: http://plastic.pclady.com.cn/app/addDiary.jsp
说明
发日记
缓存时间
0分钟
提交方式
POST
是否登录
是
数据来源
整形库编辑后台
修改内容
1:请求参数添加surgeryDate、nodeDate、appVersion字段
2:当版本号大于210 时,content中包括图片和文字,图片用img标签组装
3:添加diaryDependId参数,审核不通过重新编辑时用到。(2.2.0需求)
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| diaryID | 日记ID | string | "" | 是 | 没传ID表示新日记,有ID表示续写 |
| projectID | 项目ID | string | "" | 是 | "三级ID1,三级ID2,三级ID3",类别ID用英文逗号隔开 |
| title | 标题 | string | "" | 是 | |
| content | 内容 | string | "" | 是 | |
| image | 图片 | string | "" | 是 | 用;myAppImg;隔开,最多9张 |
| orgID | 机构ID | string | "" | 否 | 模糊搜索选择的机构需要传ID ,不用传名称 |
| orgName | 手动输入的机构名 | string | "" | 否 | 新增机构需要传名称,不需要ID |
| orgCity | 机构所在城市 | string | "" | 否 | |
| orgDoctorID | 机构中的医生 | string | "" | 否 | 模糊搜索选择的医生需要传ID ,不用传名称 |
| orgDoctorName | 手动输入的医生 | string | "" | 否 | 新增医生需要传名称,不需要ID |
| price | 价格 | string | "" | 否 | |
| orderID | 订单ID | string | "" | 否 | 晒单要传订单ID,传入订单号时,机构等信息和项目信息不需要传 |
| surgeryDate | 手术时间 | string | "" | 否 | 手术时间 ,新增日记时为必填,续写时不需要传 |
| nodeDate | 当前节点时间 | string | "" | 否 | 当前节点时间,版本号大于等于2.1.0时为必填 |
| appVersion | 版本号 | string | "" | 否 | 版本号去掉.如2.1.0->210 |
| diaryDependId | 节点ID | string | "" | 否 | 审核不通过的日记节点ID |
返回
{
"status":0,
"msg":"请求成功",
"Integral":20,
"contentID",111111
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| Integral | 奖励积分 | contentID | 日记ID,新增的时候返回,续写不需要返回 |
5.2日记详情页(修改)
(mrobot已完成开发,请连开发机进行测试)
开发环境: http://dev15.pclady.com.cn/app/diaryInfo.jsp?diaryID=111&pageNo=1&pageSize=10&deviceID=91
http://dev15.pclady.com.cn/app/commentList.jsp?contentID=111&contentType=1&pageNo=1&pageSize=3
线上环境: http://plastic.pclady.com.cn/app/diaryInfo.jsp
mrobot地址: http://mrobot.pclady.com.cn/s/yimei/circle/diaryv21.xsp
说明
版本号大于等于2.1.0时,返回wap页面,第一页返回日记信息+10条评论,第二页以后返回评论信息
缓存时间
0分钟
提交方式
GET
是否登录
查询收藏状态时需要登录,其它情况不需要登录
数据来源
整形库编辑后台
修改内容
1:请求参数添加order、appVersion字段
2:返回参数添加userTypeImage、surgeryDate、afterDay
3:版本号大于等于2.1.0时,返回参数删除imageList节点
4:当appVersion大于等于2.1.0时,diaryContent返回图片混排
5:请求参数添加userID(mrobot用到)
6:返回参数添加点赞头像节点(2.2.0版本才需要添加)
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| pageNo | 页数 | int | 1 | 是 | |
| pageSize | 页面大小 | int | 10 | 是 | |
| diaryID | 日记ID | string | "" | 是 | |
| deviceID | 设备ID | string | "" | 是 | |
| fmt | fmt=json 时显示接口数据 | String | "" | 否 | |
| order | 1:正序,2:倒序 | int | 否 | ||
| appVersion | 版本号 | int | 否 | ||
| userId | 当前登录用户ID | int | 否 | 2.1.0以后为必填,morobot用到 | |
| inReview | 1:审核状态,需要显示举报按钮 | int | 否 | ios审核时用到 |
返回
{
"status": 0,
"msg": "请求成功",
"pageNo": 1,
"pageSize": 20,
"total": 100,
"diaryID": "",
"hasCollect": "",
"diaryTitle": "",
"hasLaud": "",
"userHead":[
"1234","1234"
],
"projectList": [
{
"projectID": 11,
"projectName": ""
},
{
"projectID": 11,
"projectName": ""
}
],
"isessence": 1,
"ispublicationPhoto": 1,
"org": {
"hospital": "",
"doctor": "",
"hospitalCity": "",
"price": 1200,
"orgID": 111,
"doctorID": 11111
},
"nickName": "",
"userAge": 30,
"userCity": "",
"userID": "",
"userTypeImage":["",""],
"surgeryDate": "",
"afterDay": 1,
"commentCount": 1,
"laudCount": 2,
"activityName": "",
"activityID": "",
"sysTime": "系统当前时间YYYY-MM-DD HH:mm:ss",
"data": [
{
"diaryDependId": 111,
"createTime": "",
"diaryContent": "日记内容",
"imageList":["image1","image2","image3"],
"largeImageList":["image1","image2","image3"]
}
],
}
html中的json,mrobot组装
{
"pageNo": 第多少页评论,
"pageSize": 评论分页大小,
"total":评论总数,
"commentCount": 1,
"laudCount": 2,
"hasCollect": "",
"hasLaud": 1,
"userID": "",
"title": "",
"surgeryDate": "",
"data": [
{
"largeImageList": [
"image1",
"image2",
"image3"
]
}
],
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| hasCollect | 1:收藏,2:未收藏 | diaryTitle | 日记标题 |
| projectID | 项目ID | projectName | 项目名 |
| isessence | 是否精华:1:是,0:否 | ispublicationPhoto | 是否晒单:1:是,0:否 |
| hospital | 医院名 | doctor | 医生 |
| hospitalCity | 医院所在城市 | price | 价格 |
| nickName | 用户昵称 | userAge | 用户年龄 |
| userCity | 用户所在城市 | userID | 用户ID |
| commentCount | 评论数 | laudCount | 点赞数 |
| userID | 用户ID | createTime | 发由时间 |
| imageList | 列表显示大尺寸图片 | largeImageList | 查看时需要请求大尺寸图片 |
| hasLaud | 是否点赞,1:已点赞,0:未点赞 | activityName | 活动名 |
| org | 机构信息,没有机构信息时,不需要返回该节点 | diaryDependId | 日记节点 |
| surgeryDate | 手术日期 | afterDay | 日记写到术后多少天 |
终端页跳转协议
| 名称 | 协议 | 说明 |
|---|---|---|
| 项目信息 | pcladybrowser://project-info/项目ID | |
| 活动详情页 | pcladybrowser://activities-info/活动ID | |
| 头像 | pcladybrowser://othersHomePage-list/用户ID | 日记和评论中的头像都用此协议 |
| 昵称 | pcladybrowser://othersHomePage-list/用户ID | 日记和评论中的头像都用此协议 |
| 图片 | pcladybrowser://album-photot/数组索引-图片序号 | 图片序号表示点击第几张 |
| 加载更多 | pcladybrowser://loadMore/{"data":[{"largeImageList":["image1","image2","image3"]}]} | |
| 点击回复 | pcladybrowser://reply/replyID/评论人ID(userID)-评论人名称(nickName) | 评论ID |
| 点击二级评论 | pcladybrowser://reply-second/replyID-replySecondID/回复人ID(userID)-回复人名称(nickName) | replyID:评论ID,replySecondID:二级评论ID= |
| 完善机构 | pcladybrowser://update-org/{"org": { "hospital": "", "doctor": "", "hospitalCity": "", "price": 1200, "orgID": 111, "doctorID": 11111}} | 返回机构信息,机构信息全部有数据时,『完善机构』按钮隐藏 |
| 医院主页 | pcladybrowser://business-index/医院ID | 点击医院 |
| 点击续写 | pcladybrowser://continue-diary | 续写日记 |
| 举报 | pcladybrowser://report/replyID | 举报 |
5.3帖子详情页(修改)
(mrobot已完成开发,请连开发机进行测试)
开发环境: http://dev15.pclady.com.cn/app/postInfo.jsp
线上环境: http://plastic.pclady.com.cn/app/postInfo.jsp
mrobot地址: http://mrobot.pclady.com.cn/s/yimei/circle/topicv21.xsp
说明
版本号大于等2.1.0时,返回wap页面,第一页返回帖子信息+10条评论,第二页以后返回评论信息
缓存时间
0分钟
提交方式
GET
是否登录
查询收藏状态时需要登录,其它情况不需要登录
数据来源
整形库编辑后台
修改
1:mrobot返回wap页给客户端
2:添加appVersion字段
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| pageNo | 页数 | int | 1 | 是 | |
| pageSize | 页面大小 | int | 10 | 是 | |
| postID | 帖子ID | string | "" | 是 | |
| deviceID | 设备ID | string | "" | 是 | |
| appVersion | 版本号 | int | 否 | ||
| userId | 当前登录用户ID | int | 否 | 2.1.0以后为必填,morobot用到 | |
| inReview | 1:审核状态,需要显示举报按钮 | int | 否 | ios审核时用到 |
返回
{
"status":0,
"msg":"请求成功",
"pageNo": 1,
"pageSize": 20,
"total":100,
"title":"",
"nickName":"",
"userID":"",
"userAge":,
"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":""
"
}],
"projectList":[{
"projectID":11,
"projectName":""
},{
"projectID":11,
"projectName":""}],
}],
"org":{
"hospital":"",
"doctor":"",
"hospitalCity":"",
"price":1200,
}
html中的json
{
"circleName":"",
"pageNo": 第多少页评论,
"pageSize": 评论分页大小,
"total":评论总数,
"commentCount":1,
"laudCount":2,
"hasCollect":""
"hasLaud":1,
"userID":"",
"title":"",
"data":[{
"largeImageList":["image1","image2","image3"]
"
}],
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| title | 标题 | data | 帖子数据 |
| nickName | 发布人昵称 | userID | 用户ID |
| age | 发布人年龄 | city | 发布人所在城市 |
| circleName | 圈子名 | content | 帖子内容 |
| hasCollect | 1:收藏,2:未收藏 | createTime | 发帖时间 |
| commentCount | 评论数 | laudCount | 点赞数 |
| imageList | 列表显示大尺寸图片 | largeImageList | 查看时需要请求大尺寸图片 |
| isessence | 是否精华:1:是,0:否 | ispublicationPhoto | 是否晒单:1:是,0:否 |
| hasLaud | 是否点赞,1:已点赞,0:未点赞 | projectList,org | 旧案例数据可能会包括这两个节点的信息,没有该数据时,节点也不返回 |
| postDependId | 帖子节点 |
终端页跳转协议
| 名称 | 协议 | 说明 |
|---|---|---|
| 项目信息 | pcladybrowser://project-info/项目ID | |
| 头像 | pcladybrowser://othersHomePage-list/用户ID | 帖子和评论中的头像都用此协议 |
| 昵称 | pcladybrowser://othersHomePage-list/用户ID | 帖子和评论中的头像都用此协议 |
| 图片 | pcladybrowser://album-photot/数组索引-图片序号 | 图片序号表示点击第几张 |
| 加载更多 | pcladybrowser://loadMore/{"data":[{"largeImageList":["image1","image2","image3"]}]} | |
| 点击回复 | pcladybrowser://reply/replyID/评论人ID(userID)-评论人名称(nickName) | 评论ID |
| 点击二级评论 | pcladybrowser://reply-second/replyID-replySecondID/回复人ID(userID)-回复人名称(nickName) | replyID:评论ID,replySecondID:二级评论ID= |
| 点击续写 | pcladybrowser://continue-topic | 续写帖子 |
| 医院主页 | pcladybrowser://business-index/医院ID | 点击医院 |
| 举报 | pcladybrowser://report/replyID | 举报 |
5.4发帖子(修改)
开发环境: http://dev15.pclady.com.cn/app/addPost.jsp
线上环境: http://plastic.pclady.com.cn/app/addPost.jsp
说明
发帖子
缓存时间
0分钟
提交方式
POST
是否登录
是
数据来源
整形库编辑后台
修改内容
1:请求参数添加appVersion字段
2:当版本号大于210 时,content中包括图片和文字,图片用img标签组装
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| postID | 日记ID | string | "" | 是 | 没传ID表示新帖子,有ID表示续写 |
| circleID | 圈子ID | string | "" | 是 | |
| title | 标题 | string | "" | 是 | |
| content | 内容 | string | "" | 是 | |
| image | 图片 | string | "" | 是 | 用;myAppImg;隔开,最多9张 |
| appVersion | 版本号 | int | "" | 否 |
返回
{
"status":0,
"msg":"请求成功",
"Integral":20,
"contentID",111111
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| Integral | 奖励积分 | contentID | 帖子ID,新增的时候返回,续写不需要返回 |
5.5评论列表
(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
是否登录
否
数据来源
整形库编辑后台
修改说明
请求参数添加appVersion参数,2.1.0以后表情返回图片地址
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| pageNo | 页数 | int | 1 | 是 | |
| pageSize | 页面大小 | int | 10 | 是 | |
| contentID | 文章ID | string | "" | 是 | |
| contentType | 文章类型 | string | "" | 是 | 1:日记,2:帖子 |
| appVersion | 版本号 | int | 否 | 2.1.0以后必填 |
返回
{
"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":"回复内容"
"
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 | 评论总数 |
5.6用户日记列表(修改)
(mrobot已完成,请连开发机进行测试)
开发环境: http://dev15.pclady.com.cn/app/myDiaryList.jsp
线上环境: http://plastic.pclady.com.cn/app/myDiaryList.jsp
mrobot地址: http://mrobot.pclady.com.cn/s/yimei/my/myDiaryList.xsp
说明
获取用户日记列表
缓存时间
0
提交方式
GET
是否登录
是
数据来源
整形库编辑后台
修改说明
返回时添加surgeryDate(手术时间)参数
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|---|---|---|---|
| pageNo | 页数 | int | 1 | 是 |
| pageSize | 页面大小 | int | 10 | 是 |
| appVersion | 版本号,如果是旧日记,把最早节点的时间作为手术时间 | int | 10 | 是 |
返回
{
"status":0,
"msg":"请求成功",
"pageNo": 1,
"pageSize": 20,
"total": 100,
"sysTime":"系统当前时间YYYY-MM-DD HH:mm:ss
"
"data":[{
"contentID":"",
"imageUrl":"image1",
"title":"",
"commentCount":1,
"laudCount":1,
"dateTime":"刚刚",
"surgeryDate":"手术时间,YYYY-MM-DD"
}
]
}
返回参数说明
| 参数名 | 参数含义 | 参数名 | 参数含意 |
|---|---|---|---|
| contentID | 内容ID | imageUrl | 日记图片,取最新的一张 |
| title | 标题 | dateTime | 发表时间,取最新的时间 |
| commentCount | 评论数 | laudCount | 点赞数 |
6.1用户信息
6.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 | 用户总积分 |
7城市列表
7.1城市列表(mrobot修改)
(接口已完成,使用请连开发机代理)
CMS地址:
旧地址: http://plastic.pclady.com.cn/ym2015/nq/1503/intf7227.js
新地址: http://plastic.pclady.com.cn/ym2015/nq/1508/intf9007.js
mrobot地址: http://mrobot.pclady.com.cn/x-86400-g2u/yimei-cms/ym2015/nq/1508/intf9007.js
说明
2.1.0后返回CMS新地址的内容
缓存时间
24小时
提交方式
GET
数据来源
CMS
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 |
|---|
返回
{
"status": 0,
"msg": "请求成功",
"data": [
{"name" : "北京"," id" : 110230},
]
}
7.2 举报终端页
(mrobot已完成开发,请连开发机进行测试)
mrobot接口: http://mrobot.pconline.com.cn/s/onlineinfo/bbs/report.xsp?isBBS=1&topicId=52553893&postId=526010636
后端接口: http://bbs.pconline.com.cn/action/post/reportAbuse.do
缓存时间
无
提交方式
get
是否登录
是
数据来源
无
参数
| 参数名 | 类型 | 必须 | 说明 |
|---|---|---|---|
| isBBS | string | 是 | isBBS=1时来自评论;isBBS=0时来自日记/帖子| |
| topicId | string | 是 | 帖子id或日记id |
| postId | string | 是 | 评论id,当举报来自日记/帖子时postId=0 |
返回 HTML
7.3新增用户
开发环境: http://dev15.pclady.com.cn/app/addUser.jsp
线上环境: http://plastic.pclady.com.cn/app/addUser.jsp
说明
注册成功后,通知平台添加用户和积分
缓存时间
0
提交方式
POST
是否需要登录
是
数据来源
整形库编辑后台
参数
| 参数名 | 参数含义 | 类型 | 默认值 | 是否必须 | 说明 |
|---|---|---|---|---|---|
| r | 时间截 | String | "" | 是 | |
| sign | MD5加密串 | String | "" | 是 | |
| type | 类型 | String | "" | 否 | 1:qq,2:微信,3:新浪 |
| nickName | 昵称 | String | "" | 否 |
返回
{
status:0,
msg:”请求成功”
}
![(please configure the [header_logo] section in trac.ini)](http://www1.pconline.com.cn/hr/2009/global/images/logo.gif)