wiki:pclady_2.0.0

Version 36 (modified by limingjiu, 12 years ago) (diff)

增加接口说明

爱妆客 V2.0.0

一、项目概况

1、APP2.0.0版本的主要的功能概况

1)扫码功能
2)抢试用
3)个人中心
4)产品架构调整

2、项目人员

1)编辑:傅带娣
2)产品:帅红、吴凯达
3)UE:程浩文
4)设计:黄淑慧
4)协调:许永佳
5)iOS开发:杨波
6)制作:
7)移动端接口:

3、时间计划

1)设计:
2)开发:
3)测试:
4)提交:

三、详细需求

1、产品原型

 V1  V2 V3 V4

2、需求说明

2.1 首页

 首页需求

2.2 条形码功能

 扫码需求

2.3 找美妆-按分类

位置:框架页04
【搜索框】
1、点击搜索,搜索窗从上面往下划出(先),键盘从下往上滑出(后)。
2、其他功能与一期一致。

【产品库】
字段说明:
1、产品图片:尺寸根据设计稿而定。
2、产品名称:显示产品类别的名称,如“面霜”
功能说明:
1、点击分类,切换到分类栏目,栏目下划分多个分类菜单,所有菜单默认闭合。
2、点击已闭合的菜单,菜单向下展开,点击已展开的菜单,菜单向上闭合;点击展开一个菜单的同时,其余菜单均闭合。
3、点击图片或文字,进入对应的分类产品列表页(框架页04-1)。
4、当在某一菜单项内滑动下方的产品,菜单项在顶部保持不动。当滑至下一菜单项,前一菜单项跟随其产品内容往上滑动。

2.4 找美妆-按功效

位置:框架页04
【搜索框】
1、点击搜索,搜索窗从上面往下划出(先),键盘从下往上滑出(后)。
2、其他功能与一期一致。

【产品库】
字段说明:
1、产品图片:尺寸根据设计稿而定。(更多功效无图片)
2、产品名称:显示产品类别的名称,如“面霜”
功能说明:
1、点击功效,切换到功效栏目,默认展开基础功效菜单。
2、点击已闭合的菜单,菜单向下展开,点击已展开的菜单,菜单向上闭合;点击展开一个菜单的同时,其余菜单均闭合。
3、点击图片或文字,进入对应的分类产品列表页(框架页04-1)。
4、当在某一菜单项内滑动下方的产品,菜单项在顶部保持不动。当滑至下一菜单项,前一菜单项跟随其产品内容往上滑动。

2.5 产品列表页

功能与1期保持一致

2.6 搜索结果页

功能与1期保持一致

2.7 产品终端页

 产品终端页

2.8 专业评测文章页

功能说明(新增):
专业评测详情页页面与1期保持一致,增加以下手势:
1、页面滑到底部,自动加载到下一个分页,如默认是“实际效果”,到了底部继续下拉,则打开“外观质地”分页;
2、页面从左向右滑动,返回产品详情页点击前所在的位置(即页面高度)。

2.9 我要评论页

位置:框架页04-3
功能描述:
正常状态:
1、评价:点击选择赞、中立或踩,选中后按钮做颜色变化。
2、标题:点击后调出中文输入键盘,页面向上移动,只漏出标题及以下的内容。
3、正文:点击后调出中文输入键盘。
4、照片:点击照片,选择照片模块从页面底部往上滑出,可选择拍照或在相册挑选。确定图片后统一在下方显示,点击图片右上角的“x”,删除图片。点击空白区域,选择照片模块从上向下滑出。
5、发布:
1)点击后,将内容提交到化妆品库后台,未登录时以匿名网友的身份提交,登录时以用户身份提交;成功提交后,提示“发布成功”,并返回产品终端页。
2)当提交的内容为空时,则无法提交并提示“您尚未输入点评内容。”
3)评论发布失败时,提示“发布失败,请重新提交”。
4)填写了内容后,按关闭按钮,提示“您尚未提交评价,是否放弃编辑?”,选择是,返回产品终端页。选择否,继续编辑。
5)提交时无网络,提示“网络不佳,请重新提交”。
6、用户点击home键或其他突发情况退出应用时,自动记录最后一次编辑状态;当用户下一次进入此评论页面时,自动读取最后一次编辑状态。
7、用户未登录App时,页面下方空白处提示“您尚未登录,登录后交流更方便!”,点击“登录”跳转至登录页面,登录成功后自动回到评论页。
8、用户登录后,所发表的点评要以对应的帐号把数据同步到web端。
异常状态:
1、无网络时显示默认无网络页面,点击进行刷新。

2.10 全部评论页

位置:框架页04-4
【整个页面】
功能说明:
正常情况:
1、点击进入评论详情(页04-5),页面从右向左滑出;
2、手势向上滑动,页面内容不断加载。
3、拉到底部仍然手势向上,提示“没有更多了”。
4、切换头部筛选选项时,页面刷新一次。
异常情况:
1、无网络时显示默认无网络页面,点击进行刷新。
2、网络不佳时提示:黑色层+图标+“网络不给力”。

【头部筛选】
功能说明:
1、当没有试用时,显示“全部”、“赞”、“中立”、“踩”四项选择。
2、当有使用时,显示“全部”、“试用”、“赞”、“踩”四项选择。

【评论内容】
字段说明:
1、评论内容:最多显示3行,超出用“…”表示。
2、评论时间:用年-月-日-时-分来表示,如“2014-02-14”
3、赞:最多显示999,超出显示999+。

样式调整:
1、调整“试用”“精”显示的位置,与跟“表情”赞踩图标放同一行;

功能说明(增加):
1、点击“赞”,出现弱提示“+1”,并把数据同步到Web端,相当于Web端的“有用”按钮。
2、点击评论,进入评论详情页(页04-5)。
3、当评论数为0时,该模块隐藏。

2.11 评论详情页

位置:框架页04-5
样式调整:
1、个人信息模块提前,位置在评分前。
功能说明:(增加)
正常情况:
1、右上角增加分享按钮,点击后显示分享浮层从下往上滑出。
2、默认文案:
腾讯微博,QQ空间,新浪微博默认内容:“我在爱妆客app发现了一款产品,网友评价不错的~+产品名称+http地址+下载爱妆客吧~+iPhone版下载地址”
微信好友,朋友圈,QQ好友:爱妆客分享+评论图片+产品名称+http地址
3、页末增加赞功能,点击赞,弱提示“+1”。
4、手势滑动进行内容加载,滑至页面底部依然手势向上,提示“没有更多内容”。
5、手势从左向右滑动,返回上一页点击前所在的位置(即页面高度)

异常情况:
1、无网络时显示默认无网络页面,点击进行刷新。
2、网络不佳时提示:黑色层+图标+“网络不给力”。

2.12 找美妆-按品牌

位置:框架页05

【品牌搜索框】
1、点击搜索框,搜索窗从上面往下划出(先),键盘从下往上滑出(后)。
2、其他功能与一期一致。

【品牌列表】
字段说明:
1、热门品牌:logo展示,读取后台热门品牌logo
2、全部品牌:英文名+中文名(无则不显示)
3、字母索引:@代表热门品牌

功能说明:
正常状态:
1、点击按分类/按功效/按品牌TAB,或者在页面左右滑动,可以切换至找美妆-按分类/找美妆-按功效/找美妆-按品牌;
2、选择地区标签(全部、欧美、日韩、国货),品牌列表随之刷新;
3、滑动或点击字母索引条时,屏幕中间显示当前字母,当前字母对应的品牌置顶,索引条有背景颜色变化,索引条中当前字母有颜色变化;
4、其他功能与上一版本一致。

异常状态:
1、无网络时显示默认无网络页面,点击进行刷新。
2、网络不佳时提示:黑色层+图标+“网络不给力”。

2.13 品牌主页

 品牌主页

2.14 进行中的试用

位置:框架页06

【试用列表】
字段说明:
1、产品图片:读取试用中心的产品图片,保持统一比例;点击图片进入试用详情页
2、试用标题:读取试用中心的产品标题,最多2行;点击标题进入试用详情页
3、价格:读取试用产品的价格
4、规格:读取试用产品的规格
5、份数:读取试用产品的份数
6、剩余时间:读取试用剩余申请时间,按X天X时X分的格式显示
7、申请按钮:
正常申请时间未申请--按钮可以点击,进入申请页,按钮文字为“我要申请”
已申请--按钮变灰不可点击,按钮文字改为“已申请”
过了申请时间--按钮变灰不可点击,按钮文字改为“已过期”

功能说明:
正常状态:
1、进入“抢试用”页,默认加载5个试用,每次往下滑动,再加载5个,往下一直把所有的正在试用都读取出来。已过期的试用,最多读取最近的10个。

异常状态:
1、无网络时显示默认无网络页面,点击进行刷新。
2、网络不佳时提示:黑色层+图标+“网络不给力”。

【整个页面说明】
1、从此点击进入其他页,原页面向左滑动消失;
2、页面按翻页加载,滑动到页面底部再加载。
3、页面在顶部往下拉动,刷新页面
4、点击试用文章区域,该区域要有点击触发效果

2.15 试用详情

位置:框架页06-1

【顶部导航】
功能说明:
1、返回按钮:点击返回至“进行中的试用”
2、分享按钮:点击后,从屏幕底部滑出分享页面

【试用详情】
字段说明:
1、产品图片、试用标题、价格、规格、数量:数据读取与“进行中的试用”一致;
2、申请人数:数据读取后台已申请人数;
3、试用说明:读取后台数据。

功能说明:
正常状态:
1、点击申请按钮,进入试用申请页面。

【整个页面说明】
1、从此点击进入其他页,原页面向左滑动消失;
2、页面按翻页加载,滑动到页面底部再加载。
3、页面拉到底部,页面自动回弹
4、页面向右滑动,返回上一页点击前所在的位置(即页面高度)

2.16 试用申请

位置:框架页06-2

【顶部导航】
功能说明:
1、关闭按钮:返回至试用详情。 2、提交按钮:点击后,根据不同状态提示相应信息。

【收货信息】
字段说明:
1、姓名:点击调用中文输入键盘;真实姓名必须由2-4个汉字组成;
2、地址:省市,点击调用地址转盘;街道地址,点击调用文字输入键盘;详细地址字数须在5至60之间;
3、手机:点击调用数字键盘;必须由5-20位数字组成;
4、邮箱:点击调用英文输入键盘;必须带有@字符;
5、记住:默认选中,选中后,下次用户申请时,上述填写框显示上次填写的信息;不勾选则无需显示。
6、登录的用户,其申请的试用,要以对应的帐号把数据同步到web端。

功能说明:
正常状态:
1、点击提交,若填写的字段完整且符合规定,提示“提交成功”,并进入申请成功提示页面。
2、点击提交,若姓名、地址、手机号、邮箱有一项未填写,则无法提交并提示“您填写的信息不完整,请填写完整!”
3、点击提交,若手机号(需为11位数字)、邮箱(需带有@)不符合规定,则无法提交并提示“您填写的手机号(邮箱)格式有误,请重新填写!”
4、填写了内容后,按关闭按钮,提示“您尚未提交试用申请,是否放弃编辑?”,选择是,返回试用详情页。选择否,继续编辑。
5、用户未登录App时,页面提示“您尚未登录,登录后参加活动更方便!”。点击“登录”二字即可快捷登录。

异常状态:
1、若提交失败,则提示“提交失败,请重新提交!”
2、提交时网络不佳或没有网络,提示“网络不佳,请重新提交!”

2.17 申请成功

位置:框架页06-3

【提示信息】
功能说明:
1、点击返回按钮,返回至试用详情页。
点击相应ICON可分享至:微信朋友圈、微信好友、新浪微博、QQ好友、QQ空间、腾讯微博,分享页面从下往上滑出,其他功能与一期一致。
2、点击“个人中心—我的试用”可进入“个人中心-试用”;

2.18 试用预告

位置:框架页06-4

【试用列表】
字段说明:
1、产品图片、试用标题、价格、规格、份数:数据读取与“进行中的试用”一致;
2、倒计时:读取距离开始申请的剩余时间,按X天X时X分的格式显示;

功能说明:
1、用户点击“到时提醒我”按钮后,在申请开始的当天,触发系统推送消息,内容如下:
爱妆客 [产品标题]今天开抢啦,[份数]抢完就没罗
2、无查看试用详情功能,其他与“进行中的试用”一致。

【整个页面说明】
1、从此点击进入其他页,原页面向左滑动消失;
2、页面按翻页加载,滑动到页面底部再加载。
3、页面在顶部往下拉动,刷新页面

2.19 我的试用

 我的试用

2.20 提交试用报告

位置:框架页07-1
功能说明:
1、主要功能、样式与“我要点评”一致;
2、提交后的评论类型需为“试用报告”,并关联到web版上的试用报告。
3、绑定了新浪微博或QQ的用户,以该第三方昵称作为用户名提交报告。

2.21 我的收藏

 我的收藏

2.22 我的点评

 我的点评

2.23 设置

位置:框架07-4
功能说明:
1、增加清除缓存、应用推荐、退出登录按钮;
2、点击退出登录按钮,个人中心用户头像变为系统默认头像,用户名变为登录提示语。

2.24 登录

位置:框架07、07-5
功能说明:
1、未登录时,用户头像为系统默认头像;
2、点击头像跳转至登录页;
3、在登录页面,输入太平洋通行证账号、密码,再点击登录按钮即可,可以选择记住登录状态;
4、也可以用合作账号(微博、QQ)登录,首次用合作账号登录需绑定;
5、登录成功,个人中心显示用户头像与用户名。

3、设计稿

 设计稿地址

4、页面路径及页面名称、魔方自定义事件、计数器统计规则文档

5、接口规则

5.1. “主页-广告、抢试用、榜单”接口

备注:修改接口,获取“主页-广告、试用、榜单”(原index_enter接口修改,增加“抢试用”列表,修改“榜单列表”增加“标题”、“简介”字段)
请求URL: http://cosme.pclady.com.cn/interface/app/v2/index_enter.jsp
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:*
缓存时间:*
请求参数:无
请求后端URL:*
请求后端参数:*
返回

{
  "focus": [		//数组,轮播广告
    {				//字典,焦点图项
      "img": "",	//URL,图片
      "type": 1,	//int,类型。1:文章, 2:产品, 3:评测, 4:榜单, 5:外链
      "article": {	//字典,当type为1时,文章终端页面相关属性
        "id": ""	//string,文章ID,用于拼装文章页面URL
      }
    },
    {
      "img": "",
      "type": 2,
      "product": {	//字典,当type为2时,产品终端相关属性
        "id": ""	//string,产品ID,用于拼装产品详情页面URL
      }
    }
    {
      "img": "",
      "type": 3,
      "test": {		//字典,当type为3时,产品评测终端相关属性
        "id": "",	//string,产品ID,用于拼装专业评测页面URL
        "name": ""
      }      
    },
    {
      "img": "",
      "type": 4,
      "ranking": {	//字典,当type为4时,榜单相关属性
        "key": ""	//string,榜单名字,索引提交的
      }
    },
    {
      "img": "",
      "type": 5,
      "web": {		//字典,当type为5时,外链相关属性
        "url": ""	//url,外链地址
      }
    }
  ],
  "trials": [		//数组,试用品数据,固定三个
    {
      "time": "",     //string,试用结束时间
      "title": "",    //大标题
      "subtitle": "", //小标题
      "img": "",      //图片
      "count": "",    //试用品份数
      "id": "",       //试用品ID
    }
  ],
  "rankings": [			//数组,榜单列表
    {					//字典,榜单项
      "img": "",		//URL,图片URL
      "key": "",		//string,榜单名字,索引提交的
      "title": "",		//string,标题
      "subtitle": "",	//string,子标题
    }
  ],
  "msg": "",
  "ret": 0
}

5.2. “条码匹配产品”接口

备注:新增接口,使用扫描到的条码匹配返回对应产品信息。
请求URL: http://cosme.pclady.com.cn/interface/app/v2/barcode.jsp?id=110110110
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:*
缓存时间:*
请求参数:

id //条码编号

请求后端URL:*
请求后端参数:*
返回

{
  "product": {      //字典,产品数据
    "brand": "",    //品牌
    "c_count": 88,  //int, 评论数
    "id": "",       //string, 产品ID, 用于拼装产品详情页面URL
    "img_l": "",    //url, 大图
    "img_s": "",    //url, 小图
    "name": "",     //string, 产品名称
    "price": 1350,  //float, 价格
    "score": 9.3,   //float, 评分
    "model": "",    //string, 规格
    "source": "",   //string, 条码数据来源
    "url": "",      //url, 产品详情页面
    "type": ""      //string, 类别
  },
  "msg": "",
  "ret": 0
}

5.3. “推荐产品入库”接口

备注:新增接口,当扫码结果匹配不到化妆品库内的数据时,可录入推荐产品入库。
请求URL: http://cosme.pclady.com.cn/interface/app/v2/recommend_product.jsp
HTTP请求方式:POST
是否需要登录:否
返回格式:json
缓存方式:*
缓存时间:*
请求参数:

name //产品名称, 
model //产品规格, 
barcode //产品条码

请求后端URL:*
请求后端参数:*
返回

{
  "msg": "提交成功!",
  "ret": 0
}

5.4. “找美妆-按分类”接口

备注:修改接口,找美妆-按分类。(原search_category接口修改,增加每个分类对应的图片)
请求URL: http://cosme.pclady.com.cn/interface/app/v2/search_category.jsp
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:*
缓存时间:*
请求参数:无
请求后端URL:*
请求后端参数:*
返回

{
  "data": [           //数组, 分类列表
    {
      "hots" : [	  //数组, 分类下的热门分类列表
        [
          {
          "id": 1,    //int, ID
          "name": "", //string, 名称
          "q": "",    //string, 名称
          "img": ""	  //url, 图片URL
          }
        ],
        [
          {
          "id": 1,    //int, ID
          "name": "", //string, 名称
          "q": "",    //string, 名称
          "img": ""	  //url, 图片URL
          }
        ],
        [
          {
          "id": 1,    //int, ID
          "name": "", //string, 名称
          "q": "",    //string, 名称
          "img": ""	  //url, 图片URL
          }
        ]
      ],    
      "children": [   //数组, 分类下的子分类
        {
          "id": 1,    //int, ID
          "name": "", //string, 名称
          "q": ""     //string, 名称          
        }
      ],
      "id": 1,        //int, 类别ID
      "name": ""      //string, 类别名
    }
  ],
  "msg": "",
  "ret": 0
}

5.5. 终端详情页改为web页面

备注:新,web开发。“专业评测”、“评论”、“评论的赞”、“更多精彩评论”需要定义响应事件

5.6. “产品终端评论点赞”接口

备注:新增接口,对产品终端的某条评论点赞
请求URL: http://cosme.pclady.com.cn/interface/app/v2/like.jsp
HTTP请求方式:POST
是否需要登录:否
返回格式:json
缓存方式:*
缓存时间:*
请求参数:

id //评论编号

请求后端URL:*
请求后端参数:*
返回

{
  "msg": "提交成功!",
  "ret": 0
}

5.7. "产品终端评论提交"接口

备注:新增接口,产品终端评论提交
请求URL: http://cosme.pclady.com.cn/interface/app/v2/comment.jsp
HTTP请求方式:POST
是否需要登录:否
返回格式:json
缓存方式:*
缓存时间:*
请求参数:

id //评论产品的ID
score //赞: 0、中立: 1、踩: 2
title //标题
desc //描述
images //图片

请求后端URL:*
请求后端参数:*
返回

{
  "msg": "提交成功!",
  "ret": 0
}

5.8. “评论列表”接口

备注:修改接口,修改原comment_list接口,增加每一条评论对应的“赞”的数量字段,修改接口支持按“全部、试用、赞、中立、踩”获取数据
请求URL: http://cosme.pclady.com.cn/interface/app/v2/comment_list.jsp
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:*
缓存时间:*
请求参数:

id //评论产品的ID
tag //分类 0、1、2、3、4
page //页数
size //每页条数

请求后端URL:*
请求后端参数:*
返回

{
  "list": [
    {
      "age": "",		//string, 年龄
      "audit": 3,		//int, 1:好, 2:一般, 3:不好
      "content": "",	//string, 评论内容
      "digest": true,	//bool, true:显示精华图标, 否则不显示
      "id": "",			//string, 评论id
      "logo": "",		//url, 用户头像
      "name": "",		//string, 昵称
      "skin": "",		//string, 肤质
      "status": 2,
      "time": "",		//date, 评论时间
      "try": false,		//bool, true:显示试用图标, 否则不显示
      "vip": true,		//bool, true:显示达人图标, 否则不显示
      "like": 999		//int, 赞的数量
    },
    "tags": [
      {
        "title": "全部",
        "tag": "0",
        "count": 999
      },
      {
        "title": "试用",
        "tag": "1",
        "count": 999
      },
      {
        "title": "赞",
        "tag": "2",
        "count": 999
      },
      {
        "title": "中立",
        "tag": "3",
        "count": 999
      },
      {
        "title": "踩",
        "tag": "4",
        "count": 999
      }
    ]
  ],
  "msg": "",
  "page": 1,
  "ret": 0,
  "size": 1,
  "total": 6220
}

5.9. web端“评论详情”页面需要根据需求调整

备注:修改原有web“评论详情”页面

5.10. web端“评论详情”页面点赞的效果如需要客户端原生实现,需要定义响应事件

5.11. web端“专业评测文章”页面需要根据需求修改

备注:修改原有web“专业评测文章”页面

5.12. “找美妆-按功效”接口

备注:新增接口,找美妆-按功效。
请求URL: http://cosme.pclady.com.cn/interface/app/v2/search_effect.jsp
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:*
缓存时间:*
请求参数:无
请求后端URL:*
请求后端参数:*
返回

{
  "data": [           //数组, 分类列表
    {
      "hots" : [	  //数组, 分类下的热门分类列表
        [
          {
          "id": 1,    //int, ID
          "name": "", //string, 名称
          "q": "",    //string, 名称
          "img": ""	  //url, 图片URL
          }
        ],
        [
          {
          "id": 1,    //int, ID
          "name": "", //string, 名称
          "q": "",    //string, 名称
          "img": ""	  //url, 图片URL
          }
        ],
        [
          {
          "id": 1,    //int, ID
          "name": "", //string, 名称
          "q": "",    //string, 名称
          "img": ""	  //url, 图片URL
          }
        ]
      ],    
      "children": [   //数组, 分类下的子分类
        {
          "id": 1,    //int, ID
          "name": "", //string, 名称
          "q": ""     //string, 名称          
        }
      ],
      "id": 1,        //int, 类别ID
      "name": ""      //string, 类别名
    }
  ],
  "msg": "",
  "ret": 0
}

5.13. “搜索与榜单”接口

备注:修改接口,原list接口修改支持“按效果获取列表数据”
请求URL: http://cosme.pclady.com.cn/interface/app/v2/list.jsp
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:*
缓存时间:*
请求参数:

type //int, 接口类型, 1:搜索接口, 2:榜单接口
key	//string, 搜索关键字, 如果是榜单入口, 值为榜单名字
q //string, 索引信息字段, 用于榜单分类
sort //int, 排序方式, 1:分数, 2:人气, 3:最新, 4:价格高, 5:价格底
page //int, 页数
size //int, 每页条数	

请求后端URL:*
请求后端参数:*
返回格式:json

{
  "list": [
    {
      "brand": "",		//string, 品牌
      "c_count": 1478,	//int, 评论数
      "id": "85099",	//string, 产品ID, 用于拼装产品详情页面URL
      "img_l": "",		//url, 大图
      "img_s": "",		//url, 小图
      "name": "",		//string, 产品名称
      "price": 210,		//float, 价格
      "score": 8.5,		//float, 评分
      "type": [			//数组, 评测类型, 用于评测终端页
        {
          "id": "20",	//string, 评测类型ID
          "name": ""	//string, 评测类型名称
        }
      ],
      "url": ""			//url, 详情页面URL
    }
  ],
  "q_list": [			//数组, 索引信息字段, 用于榜单分类
    {
      "count": 4786,	//int, 结果数量
      "q": "深层清洁"	//同上
    }
  ],
  "msg": "",
  "page": 1,
  "ret": 0,
  "size": 1,
  "total": 7118
}

5.14. “品牌馆”接口

备注:修改“品牌馆接口”,增加已加心数量字段

请求URL: http://cosme.pclady.com.cn/interface/app/v2/brands.jsp
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:*
缓存时间:*
请求参数:无
请求后端URL:*
请求后端参数:*
返回格式:json

{
  "hots": [				//数组, 热门品牌
    [
      {
        "id": "",		//string, 品牌ID
        "logo": "",		//url, 品牌logo图标
        "name": ""		//string, 品牌名称
      }
    ]
  ],
  "list": [				//数组
    {
      "group": [		//数组, 同一索引字符下的品牌
        {
          "id": "",		//string, 品牌ID
          "name": "",	//string, 品牌名称
          "tag_id": 0	//int, 标签ID, 与tag中的id对应
        }
      ],
      "index": ""		//char, 索引字符
    }
  ],
  "tags": [				//数组, 返回的分类标签
    {
      "id": 0,			//int, 标签ID
      "name": ""		//string, 标签名称
    }
  ],
  "msg": "",
  "ret": 0
}

5.15. “品牌列表”接口

备注:修改“品牌列表接口”,支持“按分类筛选”
请求URL: http://cosme.pclady.com.cn/interface/app/v2/brand_list.jsp
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:*
缓存时间:*
请求参数:

id 			//品牌ID
sub_id  	//子品牌ID
category_id //分类ID
page 		//int, 页数
size 		//int, 每页条数

请求后端URL:*
请求后端参数:*
返回

{
  "cn_name": "",		//string, 中文名
  "en_name": "",		//string, 英文名
  "from": "法国",		//string, 发源地 
  "logo": "",			//url, 品牌logo
  "list": [				//数组, 列表  
    {
      "brand": "",		//string, 品牌名称
      "c_count": 4315,	//int, 评论数
      "id": "98275",	//string, 产品ID, 用于拼装产品详情页面URL
      "img_l": "",		//url, 大图
      "img_s": "",		//url, 小图
      "name": " ",		//string, 产品名称
      "price": 140,		//float, 价格
      "score": 8.3,		//float, 评分
      "type": [			//数组, 评测类型, 用于评测终端页
        {
          "id": "20",	//string, 评测类型ID
          "name": ""	//string, 评测类型名称
        }
      ],
      "url": "http://cosme.pclady.com.cn/product/98275.html"
    }
  ],
  "sub": [				//数组, 分类列表
    {
      "id": "70",		//string, 分类ID
      "name": ""		//string, 分类名称
     	    }
  ],
  "category": [			//数组, 类别列表
    {
      "id": "70",		//string, 类别ID
      "name": ""		//string, 类别名称
    }
  ],
  "msg": "",
  "page": 1,
  "ret": 0,
  "size": 1,
  "total": 474
}

5.16. 肤质测试报告页面整合对应解决功效产品榜单Top3(web页面)

5.17. 肤质拯救方案页面(web页面或者数据接口)

5.18. “试用列表”(正在进行、即将开始)

备注:获取试用列表接口

请求URL: http://cosme.pclady.com.cn/interface/app/v2/trial_list.jsp
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:*
缓存时间:*
请求参数:

tag // 0: 正在进行, 1: 即将开始
page // 页数
size // 每页数量

请求后端URL:*
请求后端参数:*
返回

{
  "list": [				//数组, 列表  
    {
      "id": "98275",	//string, 试用项ID
      "img": "",		//url, 图片
      "name": " ",		//string, 产品名称
      "price": 140,		//float, 价格
      "model": "",		//string, 规格
      "count": 20,		//int, 试用品份数	
      "time": ""		//string,试用结束时间
    }
  ],
  "msg": "",
  "page": 1,
  "ret": 0,
  "size": 1,
  "total": 474
}

5.19. “试用详情”接口

备注:试用详情页接口,正在进行的试用才有
请求URL: http://cosme.pclady.com.cn/interface/app/v2/trial_detail.jsp
HTTP请求方式:GET
是否需要登录:否
返回格式:json
缓存方式:*
缓存时间:*
请求参数:

id // 试用项ID

请求后端URL:*
请求后端参数:*
返回

{
  "data": {
    "id": "98275",		//string, 试用项ID
    "img": "",			//url, 图片
    "name": " ",		//string, 产品名称
    "model": "",		//string, 规格
    "price": 140,		//float, 价格
    "count": 20,		//int, 试用品份数	
    "time": "",			//string,试用结束时间
    "t_count": 20,		//int, 申请人数
    "instructions": [	//数组, 试用说明
      {
        "title": "",	//string, 标题
        "desc": ""		//string, 描述
      }
    ]
  },
  "msg": "",
  "ret": 0
}

5.20. “申请试用提交”接口

备注:
请求URL: http://cosme.pclady.com.cn/interface/app/v2/apply_trial.jsp
HTTP请求方式:POST
是否需要登录:否
返回格式:json
缓存方式:*
缓存时间:*
请求参数:

id //试用项ID
name //申请者姓名
address //申请者地址
phone //申请者手机
email //申请者邮箱
userId//用户ID

请求后端URL:*
请求后端参数:*
返回

{
  "msg": "",
  "ret": 0
}

5.21. “我的肤质、试用、收藏、点评”获取接口

备注:
请求URL: http://cosme.pclady.com.cn/interface/app/v2/uer_info.jsp
HTTP请求方式:GET
是否需要登录:是
返回格式:json
缓存方式:*
缓存时间:*
请求参数:

userId //用户ID
type //数据类型 0:肤质,1:试用,2:收藏,3:点评
page //页数
size //每页数量

请求后端URL:*
请求后端参数:*
返回

{
  "data" : {			//type为0, 数组为皮肤测试数据
    "list": [
      {
        "id": "",		//string, 肤质测试ID
        "img": "",		//url, 测试肤质图URL
        "time": "",		//date
        "score": 99.98	//float, 分数
      }
    ]
  },
  "data" : {			//type为1, 数组为试用数据
    "list": [
      {
        "id": "98275",	//string, 试用项ID
        "img": "",		//url, 图片
        "name": " ",	//string, 产品名称
        "time": "",		//date, 申请时间
        "status": 0		//int, 申请状态, 0:审核中, 1:已获得试用
      }
    ],
    "trials": 99,		//int, 已申请试用, type为1时才有
  	"winning": 98,		//int, 已中奖试用, type为1时才有
  },
  "data" : {			//type为2, 数组为试用数据
    "brand": [
      {
        "id": "98275",	//string, 品牌ID
        "img": "",		//url, 图片
      }
    ],
	"fav": [
      {
        "id": "98275",	//string, 产品ID
        "img": "",		//url, 图片
        "name": "",		//string, 产品名称
        "score": 9.9	//float, 分数
      }
    ]
  },
  "data" : {			//type为3, 数组为点评数据
    "list": [
      {
        "id": "98275",	//string, 评论ID
        "productId": "",//string, 被评论产品ID
        "img": "",		//url, 图片
        "name": " ",	//string, 产品名称
        "desc": "",		//string, 评论内容
        "status": 0		//int, 评论状态, 0:审核中, 1:审核通过, 2:审核不通过
      }
    ],
    "general": 99,		//int, 普通
  	"digest": 98,		//int, 精华
  	"unpass": 1,		//int, 不通过
  },
  "type": 0,		//int, 数组类型, 0:肤质,1:试用,2:收藏,3:点评
  "msg": "",
  "ret": 0
}

5.22. “我的肤质”提交接口

备注:
请求URL: http://cosme.pclady.com.cn/interface/app/v2/skin_submit.jsp
HTTP请求方式:POST
是否需要登录:是
返回格式:json
缓存方式:*
缓存时间:*
请求参数:

userId //用户ID
id //肤质测试ID
img //测试肤质图
time //date
score //分数

请求后端URL:*
请求后端参数:*
返回

{
  "msg": "",
  "ret": 0
}

5.23. “我的试用”提交接口

备注:
请求URL: http://cosme.pclady.com.cn/interface/app/v2/trial_submit.jsp
HTTP请求方式:POST
是否需要登录:是
返回格式:json
缓存方式:*
缓存时间:*
请求参数:

userId //用户ID
id //试用ID

请求后端URL:*
请求后端参数:*
返回格式:json

{
  "msg": "",
  "ret": 0
}

5.24. “我的收藏”提交接口

备注:
请求URL: http://cosme.pclady.com.cn/interface/app/v2/fav_submit.jsp
HTTP请求方式:POST
是否需要登录:是
返回格式:json
缓存方式:*
缓存时间:*
请求参数:

userID //用户ID
id //产品ID

请求后端URL:*
请求后端参数:*
返回

{
  "msg": "",
  "ret": 0
}

5.25. “提交试用报告”接口

备注:
请求URL: http://cosme.pclady.com.cn/interface/app/v2/trial_report_submit.jsp
HTTP请求方式:POST
是否需要登录:否
返回格式:json
缓存方式:*
缓存时间:*
请求参数:

id //试用条目ID
score //赞: 0、中立: 1、踩: 2
title //标题
desc //描述
images //图片

请求后端URL:*
请求后端参数:*
返回

{
  "msg": "",
  "ret": 0
}

Attachments