[[TOC]] = 爱妆客 V2.0.0 = == 一、项目概况 == === 1、APP2.0.0版本的主要的功能概况 === 1）扫码功能\\ 2）抢试用\\ 3）个人中心\\ 4）产品架构调整\\ === 2、项目人员 === 1）编辑：傅带娣、徐倩倩、彭娟[[BR]] 2）产品：帅红、吴凯达[[BR]] 3）UE：程浩文[[BR]] 4）设计：黄淑慧、夏铭康[[BR]] 4）协调：许永佳[[BR]] 5）iOS开发：杨波、许忠洲、宋晓臣、练炽金[[BR]] 6）制作：郑少凡[[BR]] 7）移动端接口：尹嘉丽、李耀豪[[BR]] 8）QA：张菊婷[[BR]] === 3、时间计划 === 1）设计：3.28-5.9[[BR]] 2）开发：5.7-6.10[[BR]] 3）测试：6.11-6.25[[BR]] 4）提交：6.26[[BR]] == 三、详细需求 == === 1、产品原型 === [[http://rdtrac.pc.com.cn/mobile/pototype/pclady/azk/ver2.0.0/yd/v1/start.html |V1]] [[http://rdtrac.pc.com.cn/mobile/pototype/pclady/azk/ver2.0.0/yd/v2/start.html |V2]][[http://rdtrac.pc.com.cn/mobile/pototype/pclady/azk/ver2.0.0/yd/v2/start.html |V3]][[http://rdtrac.pc.com.cn/mobile/pototype/pclady/azk/ver2.0.0/yd/v4/start.html |V4]][[http://rdtrac.pc.com.cn/mobile/pototype/pclady/azk/ver2.0.0/yd/v5/start.html |V5]]\\ === 2、需求说明 === === 2.1 首页 === [[http://trac.pc.com.cn/iphone/wiki/pclady_2.0.0_home |首页需求]]\\ === 2.2 条形码功能 === [[http://trac.pc.com.cn/iphone/wiki/pclady_2.0.0_scan |扫码需求]]\\ === 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 产品终端页 === [[http://trac.pc.com.cn/iphone/wiki/pclady_2.0.0_productdetail |产品终端页]]\\ === 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 品牌主页 === [[http://trac.pc.com.cn/iphone/wiki/pclady_2.0.0_brand-home |品牌主页]]\\ === 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 我的试用 === [[http://trac.pc.com.cn/iphone/wiki/pclady_2.0.0_About-trials |我的试用]]\\ === 2.20 提交试用报告 === 位置：框架页07-1\\ 功能说明：\\ 1、主要功能、样式与“我要点评”一致；\\ 2、提交后的评论类型需为“试用报告”，并关联到web版上的试用报告。\\ 3、绑定了新浪微博或QQ的用户，以该第三方昵称作为用户名提交报告。\\ === 2.21 我的收藏 === [[http://trac.pc.com.cn/iphone/wiki/pclady_2.0.0_About-favorites |我的收藏]]\\ === 2.22 我的点评 === [[http://trac.pc.com.cn/iphone/wiki/pclady_2.0.0_About-review |我的点评]]\\ === 2.23 设置 === 位置：框架07-4\\ 功能说明：\\ 1、增加清除缓存、应用推荐、退出登录按钮；\\ 2、点击退出登录按钮，个人中心用户头像变为系统默认头像，用户名变为登录提示语。\\ === 2.24 登录 === 位置：框架07、07-5\\ 功能说明：\\ 1、未登录时，用户头像为系统默认头像；\\ 2、点击头像跳转至登录页；\\ 3、在登录页面，输入太平洋通行证账号、密码，再点击登录按钮即可，可以选择记住登录状态；\\ 4、也可以用合作账号（微博、QQ）登录，首次用合作账号登录需绑定；\\ 5、登录成功，个人中心显示用户头像与用户名。\\ == 三、设计稿 == [[http://192.168.50.179/2014-04/PCLADY-aizhuangke/index.html|设计稿地址1]]\\ [[http://192.168.50.89/2014-05-1/pconline7.html|设计稿地址2]]\\ == 四、页面路径及页面名称、魔方自定义事件、计数器统计规则文档 == [[http://trac.pc.com.cn/iphone/attachment/wiki/pclady_2.0.0/%E7%88%B1%E5%A6%86%E5%AE%A2iPhone%E7%89%88V2.0.0%E9%A1%B5%E9%9D%A2%E8%B7%AF%E5%BE%84%E5%8F%8A%E9%A1%B5%E9%9D%A2%E5%90%8D%E7%A7%B0.xls|爱妆客iPhone版V2.0.0页面路径及页面名称]]\\ [[http://trac.pc.com.cn/iphone/attachment/wiki/pclady_2.0.0/%E7%88%B1%E5%A6%86%E5%AE%A2iPhone%E7%89%88V2.0.0%E9%AD%94%E6%96%B9%E8%87%AA%E5%AE%9A%E4%B9%89%E4%BA%8B%E4%BB%B6%E6%95%B4%E7%90%86.xls|爱妆客iPhone版V2.0.0魔方自定义事件整理]]\\ [[http://trac.pc.com.cn/iphone/attachment/wiki/pclady_2.0.0/%E7%88%B1%E5%A6%86%E5%AE%A2iPhone%E7%89%88V2.0.0%E8%AE%A1%E6%95%B0%E5%99%A8%E7%BB%9F%E8%AE%A1%E8%A7%84%E5%88%99.xls|爱妆客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, 条码数据来源 }, "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 //匿名评论 accountId //登录用户评论 }}} 请求后端URL：* 请求后端参数：* 返回 {{{ { "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 "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 } }}} === 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, 试用报告地址 "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": [ { "id": "98275", //string, 试用项ID "img": "", //url, 图片 "name": " ", //string, 产品名称 "time": "", //date, 申请时间 "status": 0, //int, 申请状态, 0:审核中, 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, 评论状态, 0:审核中, 1:审核通过， 2:审核不通过 "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 } }}}