wiki:pclady_2.0.0

Context Navigation

Version 92 (modified by shuaihong, 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）移动端接口：尹嘉丽、李耀豪
8）QA：张菊婷

3、时间计划

1）设计：3.28-5.9
2）开发：5.7-6.10
3）测试：6.11-6.25
4）提交：6.26

二、集中需求

== 数据需求 ==

计数器需求（点击下载）页面路径+事件key（点击下载）

== 分享文案 ==

分享功能文案戳这里

三、详细需求

1、产品原型

V1 V2 V3 V4 V5

2、需求说明

== 我要评价 ==

第一次打开，1分钟后弹出。如果用户选择不了，谢谢 --就以后都不出。选择下次吧。就第2次第3次都弹出。最多弹3次。如果选择了现在去评价，就以后都不弹出

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、登录成功，个人中心显示用户头像与用户名。

三、设计稿

设计稿地址1
设计稿地址2

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

爱妆客iPhone版V2.0.0页面路径及页面名称
 爱妆客iPhone版V2.0.0魔方自定义事件整理
 爱妆客iPhone版V2.0.0计数器统计规则

五、接口规则

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
        "brand": "",    //string, 品牌
        "c_count": 1478,  //int, 评论数
        "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
      }
    }
    {
      "img": "",
      "type": 3,
      "test": {		//字典，当type为3时，产品评测终端相关属性
        "id": "",	//string，产品ID，用于拼装专业评测页面URL
        "name": "",
        "brand": "",    //string, 品牌
        "c_count": 1478,  //int, 评论数
        "img_l": "",    //url, 大图
        "img_s": "",    //url, 小图
        "price": 210,   //float, 价格
        "score": 8.5,   //float, 评分
        "type": [     //数组, 评测类型, 用于评测终端页
          {
            "id": "20", //string, 评测类型ID
            "name": ""  //string, 评测类型名称
          }
        ],
        "url": ""     //url, 详情页面URL
      }      
    },
    {
      "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，榜单名字，索引提交的
    }
  ],
  "pro_test":     //最新一篇评测文章
  {
    "id": 1111,   //int, 产品id
    "img": "",    //url, 图片
    "title": "",  //string, 标题
    "url": "",    //url, 评测详情页URL
    "type": [     //数组, 评测类型, 用于评测终端页
      {
        "id": "20", //string, 评测类型ID
        "name": ""  //string, 评测类型名称
      }
    ]
  },
  "reviews": [    //最新的8个超级精华点评
    {
      "id": 222,    //int, 评论id
      "img": "",    //url, 图片
      "title": "",  //string, 标题
      "name": "",   //string, 用户昵称
      "like": 999,  //int, 赞的数量
      "url": ""     //url, 评论详情页URL
    }
  ],
  "msg": "",
  "ret": 0
}

5.2 “条码匹配产品”接口

备注：新增接口，使用扫描到的条码匹配返回对应产品信息。

请求URL： http://cosme.pclady.com.cn/interface/app/v2/barcode.jsp?id=110110110

HTTP请求方式：GET

是否需要登录：否

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

id //条码编号

请求后端URL：*

请求后端参数：*

{
  "product": {      //字典，产品数据
	"in_lib": 1         //int, 该产品是否在产品库中 0为不在库中，1为在产品库中
	"brand": "",		//string, 品牌
	"c_count": 1478,	//int, 评论数（in_lib为1，在产品库中时才有）
	"id": "85099",		//string, 产品ID, 用于拼装产品详情页面URL（in_lib为1，在产品库中时才有）
	"img_l": "",		//url, 大图
	"img_s": "",		//url, 小图
	"name": "",			//string, 产品名称
	"price": 210,		//float, 价格
	"score": 8.5,		//float, 评分（in_lib为1，在产品库中时才有）
	"model": "",    	//string, 规格
	"type": [			//数组, 评测类型, 用于评测终端页（in_lib为1，在产品库中时才可能有）
	  {
		"id": "20",		//string, 评测类型ID
		"name": ""		//string, 评测类型名称
	  }
	],
	"url": ""			//url, 详情页面URL（in_lib为1，在产品库中时才有）
	"source": "",   	//string, 条码数据来源
        "key": "洁面品"  //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
        }
      ],    
      "children": [   //数组, 分类下的子分类
        {
          "id": 1,    //int, ID
          "name": "", //string, 名称
          "q": ""     //string, 名称          
        }
      ],
      "id": 1,        //int, 类别ID
      "name": "",     //string, 类别名
      "count": 999	   //int, 分类下的产品数
    }
  ],
  "msg": "",
  "ret": 0
}

5.5 终端详情页改为web页面

请求的URL： http://v35.pclady.com.cn/interface/app/v2/product_index.jsp?productId=1682&ip=udid/userid PS:URL中ip参数，匿名用户为udid，登录用户为用户id。

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

调用应用方法的链接点：

“专业评测” pcladyaction://professional-assessment/?product_id=xxx

“评论” pcladyaction://review-detail/?review_id=xxx

“更多精彩评论” pcladyaction://more-review

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

备注：新增接口，对产品终端的某条评论点赞

请求URL： http://cosme.pclady.com.cn/interface/app/v2/like.jsp

HTTP请求方式：POST

是否需要登录：否

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

ip //用户使用的内网IP
id //评论编号

请求后端URL：*

请求后端参数：*

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

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

备注：新增接口，产品终端评论提交

请求URL： http://cosme.pclady.com.cn/interface/app/v2/comment.jsp

HTTP请求方式：POST

是否需要登录：否

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

id //评论产品的ID
attitude //赞: 0、中立: 1、踩: 2
title //标题
desc //描述
images //图片
openUdid //匿名评论
common_session_id //登录用户评论

请求后端URL：*

请求后端参数：*

{
  "commentId": "1232",  // string, 评论id
  "review": "",  //url, 评论详情页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端“评论详情”页面需要根据需求调整

请求的URL： http://v35.pclady.com.cn/interface/app/v2/dianping.jsp?id=1682&ip=udid/userid PS:URL中ip参数，匿名用户为udid，登录用户为用户id。

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

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

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

请求的URL： http://cosme.pclady.com.cn/interface/app/cp_art.jsp?id=85099

备注：修改原有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
        }
      ],    
      "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:榜单接口(废弃), 3:一周至尊榜
key	//string, 搜索关键字, 如果是榜单入口, 值为榜单名字
q //string, 索引信息字段, 用于榜单分类
sort //int, 排序方式, 1:分数, 2:人气, 3:最新, 4:价格高, 5:价格底
page //int, 页数
size //int, 每页条数

请求后端URL：*

请求后端参数：*

{
  "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
    }
  ],
  "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：*

请求后端参数：*

{
  "hots": [				//数组, 热门品牌
    [
      {
        "id": "",		//string, 品牌ID
        "logo": "",		//url, 品牌logo图标
        "name": ""		//string, 品牌名称
      }
    ]
  ],
  "list": [				//数组
    {
      "group": [		//数组, 同一索引字符下的品牌
        {
          "id": "",		//string, 品牌ID
          "name": "",	//string, 品牌名称
          "tag_id": 0	//int, 标签ID, 与tag中的id对应
          "heart": 999,  //int, 标心数量（粉丝）
        }
      ],
      "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
  "heart_count": 999  //int, ❤的数量
  "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"
    }
  ],
  "category": [			//数组, 类别列表
    {
      "id": "70",		//string, 类别ID
      "name": ""		//string, 类别名称
    }
  ],
  "msg": "",
  "page": 1,
  "ret": 0,
  "size": 1,
  "total": 474
}

5.16 肤质测试报告页面（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是活动ID，相当于其它地方的activityID
      "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, 申请人数
    "instruction": ""    //string, 带HTML标签
  },
  "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 //申请者邮箱
openUdid //匿名ID
accountId //登录用户

请求后端URL：*

请求后端参数：*

{
  "msg": "",
  "ret": 0,
   "id": "98275"  //string, 申请试用的ID
}

5.21 “我的肤质”同步接口

备注：需要完善，需要等合作商确认完提供的数据，后台要去重，因为客户端并不拿到全部数据做去重。

请求URL： http://cosme.pclady.com.cn/interface/app/v2/skin_sync.jsp

HTTP请求方式：POST

是否需要登录：是

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

{
  "openUdid": "匿名用户ID",
  "accountId": "登录用户",
  "list": "[{\"id\":11111,\"img\":\"http://pclady.com.cn~~~\",\"time\":\"20140430\",\"score\": 100}]"
}
说明：POST三个参数，匿名ID、用户ID、肤质信息列表构成的字符串。

请求后端URL：*

请求后端参数：*

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

5.22 “我的试用”同步接口

备注：后台要去重，因为客户端并不拿到全部数据做去重。

请求URL： http://cosme.pclady.com.cn/interface/app/v2/trial_sync.jsp

HTTP请求方式：POST

是否需要登录：是

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

{
  "openUdid": "匿名用户ID",
  "common_session_id": "登录用户",
  "list": "[1111,2222,3333]"
}
说明：POST三个参数，匿名ID、用户ID、试用信息列表构成的字符串

请求后端URL：*

请求后端参数：*

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

5.23 “我的收藏”同步接口

备注：后台要去重，因为客户端并不拿到全部数据做去重。

请求URL： http://cosme.pclady.com.cn/interface/app/v2/fav_sync.jsp

HTTP请求方式：POST

是否需要登录：是

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

{
  "common_session_id": "登录用户",
  "brand": "[1111,2222,3333]",
  "product": "[4444,5555,6666]"
}
说明：POST三个参数，用户ID、品牌列表构成的字符串、产品列表构成的字符串。

请求后端URL：*

请求后端参数：*

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

5.24 “提交试用报告”接口

备注：

请求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 //图片
openUdid //匿名评论
accountId //登录用户评论

请求后端URL：*

请求后端参数：*

{
  "report": "",  //uri, 试用报告地址
  "commentId": "",  //string, 试用报告ID
  "msg": "",
  "ret": 0
}

5.25 关于页面（web页面制作）（改为客户端实现）

5.26 应用推荐页面（web页面制作）

5.27 “我的肤质”获取接口

备注：

请求URL： http://cosme.pclady.com.cn/interface/app/v2/user_skin.jsp

HTTP请求方式：GET

是否需要登录：是

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

page //页数
size //每页数量
common_session_id //登录用户ID

请求后端URL：*

请求后端参数：*

{
  "data" : {
    "list": [
      {
        "id": "",		//string, 肤质测试ID
        "img": "",		//url, 测试肤质图URL
        "time": "",		//date
        "score": 99.98	//float, 分数
      }
    ]
  },
  "msg": "",
  "ret": 0
}

5.28 “我的试用”获取接口

备注：

请求URL： http://cosme.pclady.com.cn/interface/app/v2/user_trial.jsp

HTTP请求方式：GET

是否需要登录：是

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

page //页数
size //每页数量
common_session_id //登录用户ID

请求后端URL：*

请求后端参数：*

{
  "data" : {
    "list": [
      {
        "activity_id",     //string, 试用活动的 id
        "id": "98275",	//string, 申请试用的ID
        "img": "",		//url, 图片
        "name": " ",	//string, 产品名称
        "time": "",		//date, 申请时间
        "status": 0,	//int, 申请状态, 0:审核中, 1:已获得试用 ,  -1：申请未通过
        "report_status": 0,  //int, 试用报告提交状态, 0:未提交, 1:已提交
        "report": ""    //uri, 试用报告地址, report_status为1时必须有地址
      }
    ],
    "trials": 99,		//int, 已申请试用
  	"winning": 98,	//int, 已中奖试用
  },
  "msg": "",
  "ret": 0,
  "page": 1,              //当前页数
  "total": 6220         //总试用数
}

5.29 “我的收藏”获取接口

备注：

请求URL： http://cosme.pclady.com.cn/interface/app/v2/user_fav.jsp

HTTP请求方式：GET

是否需要登录：是

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

common_session_id //登录用户ID

请求后端URL：*

请求后端参数：*

{
  "data" :
    "brand": [
      {
        "id": "98275",	//string, 品牌ID
        "img": "",		//url, 图片
      }
    ],
	"fav": [
      {
        "id": "98275",	//string, 产品ID
        "img": "",		//url, 图片
        "name": "",       //string, 产品名称
        "score": 9.9,	//float, 分数
        "brand": "" ,        //string，所属品牌名称
        "c_count": 144   //int，评论数
        "price": 1350,   //float, 价格
      }
    ]
  }
  "msg": "",
  "ret": 0
}

5.30 “我的点评”获取接口

备注：

请求URL： http://cosme.pclady.com.cn/interface/app/v2/user_review.jsp

HTTP请求方式：GET

是否需要登录：是

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

page //页数
size //每页数量
common_session_id //登录用户ID

请求后端URL：*

请求后端参数：*

{
  "data" : {
    "list": [
      {
        "id": "98275",	//string, 评论ID
        "productId": "",//string, 被评论产品ID
        "img": "",		//url, 图片
        "name": " ",	//string, 产品名称
        "desc": "",		//string, 评论内容
        "status": 0,	//int,  评论状态 －3 被删除 -2含有关键字 -1 审核不通过 0 待审 1 审核通过 2 精华 3 超级点评
        "review": ""       //url, 评论详情页url
      }
    ],
    "general": 99,	//int, 普通
    "digest": 98,		//int, 精华
    "unpass": 1,		//int, 不通过
  },
  "msg": "",
  "ret": 0,
  "page": 1,              //当前页数
  "total": 6220         //总点评数
}

5.31 “我的肤质”删除接口（暂时不用）

备注：

请求URL： http://cosme.pclady.com.cn/interface/app/v2/user_skin_del.jsp

HTTP请求方式：POST

是否需要登录：是

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

accountId //登录用户ID
id //删除条目ID

请求后端URL：*

请求后端参数：*

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

5.32 “我的试用”删除接口（暂时不用）

备注：

请求URL： http://cosme.pclady.com.cn/interface/app/v2/user_trial_del.jsp

HTTP请求方式：POST

是否需要登录：是

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

accountId //登录用户ID
id //删除条目ID

请求后端URL：*

请求后端参数：*

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

5.33 “我的收藏”删除接口（暂时不用）

备注：

请求URL： http://cosme.pclady.com.cn/interface/app/v2/user_fav_del.jsp

HTTP请求方式：POST

是否需要登录：是

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

accountId //登录用户ID
id //删除条目ID

请求后端URL：*

请求后端参数：*

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

5.34 “我的点评”删除接口（暂时不用）

备注：

请求URL： http://cosme.pclady.com.cn/interface/app/v2/user_review_del.jsp

HTTP请求方式：POST

是否需要登录：是

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

accountId //登录用户ID
id //删除条目ID

请求后端URL：*

请求后端参数：*

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

5.35 个人中心-登录（可以直接使用mrobot的接口）

备注：个人中心，登录
 请求URL:http://mrobot.pconline.com.cn/proxy/passport2/login
 HTTP请求方式：get
 是否需要登录：否
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数:无
返回参数：{
status: 1,
message: "帐号和密码必须输入"
}

5.36 个人中心-用户信息（可以直接使用mrobot的接口）

备注：个人中心，登录之后的用户信息
 请求URL:http://mrobot.pconline.com.cn/v3/itbbs/getUserInfo
 HTTP请求方式：get
 是否需要登录：是
 返回格式：json
 缓存方式：无
 缓存时间：无
 请求参数:无
返回参数：{
image: "http://i1.3conline.com/images/upload/upc/face/0/0_50x50",
userId: 0
}

5.37 意见反馈（已有）

5.38 热门搜索词接口（已有）

5.39 终端产品商家列表接口（已有）

5.40 “我的点评”同步接口

备注：新增，后台要去重，因为客户端并不拿到全部数据做去重。

请求URL： http://cosme.pclady.com.cn/interface/app/v2/review_submit.jsp

HTTP请求方式：POST

是否需要登录：是

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

{
  "openUdid": "匿名用户ID",
  "common_session_id": "登录用户ID",
  "list": "[1111,2222,3333]"
}
说明：POST三个参数，匿名ID、用户ID、点评信息列表构成的字符串。

请求后端URL：*

请求后端参数：*

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

5.41 试用状态查询接口

备注：新增

请求URL： http://cosme.pclady.com.cn/interface/app/v2/trial_status.jsp

HTTP请求方式：POST

是否需要登录：否

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

{
  "list": "[1111,2222,3333]"
}
说明：POST一个个参数，需要查询试用状态的试用ID列表构成的字符串。

请求后端URL：*

请求后端参数：*

{
  "data": {
    id1: {
      status: 0
    },
    id2: {
      status: 0
    },
    id3: {
      status: 0
    }
  }
  "msg": "",
  "ret": 0
}

5.42 "试用报告"同步接口

备注：新增，后台要去重，因为客户端并不拿到全部数据做去重。

请求URL： http://cosme.pclady.com.cn/interface/app/v2/report_sync.jsp

HTTP请求方式：POST

是否需要登录：是

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

{
  "openUdid": "匿名用户ID",
  "common_session_id": "登录用户ID",
  "list": "[1111,2222,3333]"
}
说明：POST三个参数，匿名ID、用户ID、试用报告列表构成的字符串。

请求后端URL：*

请求后端参数：*

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

5.43 评论状态查询接口

备注：新增

请求URL： http://cosme.pclady.com.cn/interface/app/v2/review_status.jsp

HTTP请求方式：POST

是否需要登录：否

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

{
  "list": "[1111,2222,3333]"
}
说明：POST一个个参数，需要查询评论状态的评论ID列表构成的字符串。

请求后端URL：*

请求后端参数：*

{
  "data": {
    id1: {
      status: 0 // int  评论状态 －3 被删除 -2含有关键字 -1 审核不通过 0 待审 1 审核通过 2 精华 3 超级点评
          },
    id2: {
      status: 0 // int
          },
    id3: {
      status: 0 // int
    }
  }
  "msg": "",
  "ret": 0
}

5.44 添加产品、品牌收藏接口（2014年05月29日新增）

备注：

请求URL： http://cosme.pclady.com.cn/interface/app/v2/user_fav_add.jsp

HTTP请求方式：POST

是否需要登录：是

返回格式：json

缓存方式：*

缓存时间：*

请求参数：

"common_session_id": "common_session_id",  //string, 登录用户ID
"type": 1,  //int, 1 产品， 2 品牌
"id": "2134234"  //string, 产品或品牌ID

请求后端URL：*

请求后端参数：*

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

Attachments

爱妆客iPhone版V2.0.0计数器统计规则.xls (27.0 KB) - added by wukaida 12 years ago. 爱妆客iPhone版V2.0.0计数器统计规则
爱妆客iPhone版V2.0.0魔方自定义事件整理.xls (12.5 KB) - added by wukaida 12 years ago. 爱妆客iPhone版V2.0.0魔方自定义事件整理
爱妆客iPhone版V2.0.0页面路径及页面名称.xls (11.5 KB) - added by wukaida 12 years ago. 爱妆客iPhone版V2.0.0页面路径及页面名称
爱妆客2.0计数器统计-shh-0605.xls (14.0 KB) - added by shuaihong 12 years ago.
爱妆客分享功能文案.doc (11.5 KB) - added by shuaihong 12 years ago.
爱妆客iPhone版V2.0.0页面路径+事件key0610.xls (30.0 KB) - added by lianchijin 12 years ago. 魔方路径与自定义事件修改
爱妆客iPhone版V2.0.0页面路径+事件key0620.xls (37.5 KB) - added by shuaihong 12 years ago.
爱妆客2.0计数器统计-shh-0623.xls (14.5 KB) - added by shuaihong 12 years ago.
爱妆客iPhone版V2.0.0页面路径+事件key0624.xls (18.5 KB) - added by shuaihong 12 years ago.
爱妆客2.0计数器统计-shh-0624.xls (14.5 KB) - added by shuaihong 12 years ago.

Download in other formats:

Plain Text

Context Navigation

Table of Contents

爱妆客 V2.0.0

一、项目概况

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

2、项目人员

3、时间计划

二、集中需求

== 数据需求 ==

== 分享文案 ==

三、详细需求

1、产品原型

2、需求说明

== 我要评价 ==

2.1 首页

2.2 条形码功能

2.3 找美妆-按分类

2.4 找美妆-按功效

2.5 产品列表页

2.6 搜索结果页

2.7 产品终端页

2.8 专业评测文章页

2.9 我要评论页

2.10 全部评论页

2.11 评论详情页

2.12 找美妆-按品牌

2.13 品牌主页

2.14 进行中的试用

2.15 试用详情

2.16 试用申请

2.17 申请成功

2.18 试用预告

2.19 我的试用

2.20 提交试用报告

2.21 我的收藏

2.22 我的点评

2.23 设置

2.24 登录

三、设计稿

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

五、接口规则

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

5.2 “条码匹配产品”接口

5.3 “推荐产品入库”接口

5.4 “找美妆－按分类”接口

5.5 终端详情页改为web页面

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

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

5.8 获取“评论列表”接口

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

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

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

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

5.13 “搜索与榜单”接口

5.14 “品牌馆”接口

5.15 获取“品牌列表”接口

5.16 肤质测试报告页面（web页面）需要跟合作商确定需要完善

5.17 肤质拯救方案页面（web页面）需要完善

5.18 “试用列表”（正在进行、即将开始）

5.19 “试用详情”接口

5.20 “申请试用提交”接口

5.21 “我的肤质”同步接口

5.22 “我的试用”同步接口

5.23 “我的收藏”同步接口

5.24 “提交试用报告”接口

5.25 关于页面（web页面制作）（改为客户端实现）

5.26 应用推荐页面（web页面制作）

5.27 “我的肤质”获取接口

5.28 “我的试用”获取接口

5.29 “我的收藏”获取接口

5.30 “我的点评”获取接口

5.31 “我的肤质”删除接口（暂时不用）

5.32 “我的试用”删除接口（暂时不用）

5.33 “我的收藏”删除接口（暂时不用）

5.34 “我的点评”删除接口（暂时不用）

5.35 个人中心-登录（可以直接使用mrobot的接口）

5.36 个人中心-用户信息（可以直接使用mrobot的接口）

5.37 意见反馈（已有）

5.38 热门搜索词接口（已有）

5.39 终端产品商家列表接口（已有）