Context Navigation

基本约定

1.当接口处理正常时，HTTP STATUS CODE 返回给200。包括有正常的业务数据和数据为空的情况。

2.当接口处理异常时，HTTP STATUS CODE 返回给500，并且给出具体的错误信息。
    {
	"uri" : "/intf/albums-by-type.jsp",
	"error-code":"20502",
	"error-desc":"Need you follow uid.",
        "user-notice":"给用户的提示放在这里"
    }

    
3.接口默认的字符编码是UTF-8，接口需要实现对req-enc和resp-enc参数的支持。在JSP的最顶部，实现类似下面的代码：

        String queryString = request.getQueryString();
        String requestEncoding = getParam(queryString,"req_enc");
        String responseEncoding = getParam(queryString,"resp_enc");
        if(isNotBlank(requestEncoding)){
            request.setCharacterEncoding(requestEncoding);
        }
        if(isNotBlank(responseEncoding)){
            response.setCharacterEncoding(responseEncoding);
        }

4.所有有写操作的数据接口，必须用POST方式提交，在接口里需要判断提交方式，拒绝GET的调用请求。

5.接口中的JSON字符串，key都用双引号("")包裹，value是字符串类型时，也用双引号("")包裹，并且过滤掉回车换行，对字符串中包含的双引号(")进行转义；是数字类型时，不用引号。
6.所有接口的URL都必须是小写，参数名称也需要是小写。

1.首页接口---主题列表

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/list_theme.jsp
测试： http://dev10.pchouse.com.cn:8083/jsp/intf/list_theme.jsp

请求方式：GET

是否需要登录：否

功能说明：搜索主题，已分页形式返回

提交参数：

     "pageNo": 1
     "pageSize": 10
     "version": 1

提交参数说明：
pageNo: 分页页码
pageSize: 分页大小
version: 1为版本1.0 2为版本2.0 不传参数值时默认为1

返回参数：

{
    "total":100,
    "pageNo":1,
    "pageSize":10,
    "theme":[
        {
            "id":10,
            "logo":"http:xxxx",
            "name":"天猫双十二真情回馈活动",
            "intro":"topic descript",
            "seq": 1
        },
        {
            "id":11,
            "logo":"http:xxxx",
            "name":"天猫双十二真情回馈活动",
            "intro":"topic descript",
            "seq": 2
        },
    ]
}

返回参数说明：
total：主题总数量
pageNo：分页用页码
pageSize：分页用每页数量
theme：主题数组
id：主题的id
logo：主题图片
name：主题名称
intro：主题描述

2.主题接口

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/theme.jsp
测试： http://dev10.pchouse.com.cn:8083/jsp/intf/theme.jsp

请求方式：GET

是否需要登录：否

功能说明：根据主题id，返回整个主题信息

提交参数：

id：主题id

返回参数：

{
    "id": 1
    "name": "天猫双十二真情回馈活动",
    "logo": "http://xxxx",
    "intro": "this is intro",
    "line": [
         {
             "id": 1001,
             "style": 1,
             "seq": 1
             "products": [
                {
                    "id": 2202,
                    "name": "田园布艺沙发 sj002",
                    "src": "http://xxx",
                    "link": "http://xxx",
                    "mobileLink": "http://xxx",
                    "seq": 1,
                    "favorite": 5231
                }
             ]
         },
         {
             "id": 1002,
             "style": 3,
             "seq": 2
             "products": [
                {
                    "id": 2203,
                    "name": "田园布艺沙发 sj002abc",
                    "src": "http://xxx",
                    "link": "http://xxx",
                    "mobileLink": "http://xxx",
                    "seq": 1,
                    "favorite": 523
                },
               {
                    "id": 2204,
                    "name": "田园布艺沙发 sj002abc123",
                    "src": "http://xxx",
                    "link": "http://xxx",
                    "mobileLink": "http://xxx",
                    "seq": 2,
                    "favorite": 52
                }
             ]
         }
    ]
}

返回参数说明：
id：主题id
name: 主题名称
logo: 主题封面
intro: 主题描述
line: 主题每行信息

id: 行id
style: 行模版参数值具体请参考：附加文件：模板顺序
seq: 行排序
products: 行所包含的产品数组

id: 产品id
name: 产品名称
src: 产品封面
link: 产品链接
mobileLink: 产品手机版链接
seq: 排序
favorite: 收藏数

3.单品库首页

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/category.jsp
测试： http://dev10.pchouse.com.cn:8083/jsp/intf/category.jsp

请求方式：GET

是否需要登录：否

功能说明：返回单品库的类别

提交参数：无

返回参数：

{
    "categories":{
        "1001":{
            "level":1,
            "seq":1,
            "name":"客厅",
            "logo":"http://",
            "intro":""
        },
        "1002":{
            "level":1,
            "seq":2,
            "name":"卧室",
            "logo":"http://",
            "intro":""
        },
        "100101":{
            "level":2,
            "seq":1,
            "name":"沙发",
            "logo":"http://",
            "intro":""
        },
        "100102":{
            "level":2,
            "seq":2,
            "name":"荼几",
            "logo":"http://",
            "intro":""
        }
    },
    "relations":{
        "1001":[
            100101,
            100102
        ],
        "1002":[]
    }
}

返回参数说明：
categories: 包含所有的类别(不分层级)
relations: 描述类别的关联关系(仅下级)

id：节点ID
level：节点的层次，1表示根节点。
seq：节点的顺序，同级节点之间的显示顺序。从1开始
name：节点名称
logo: 类别logo intro: 类别描述 $node id value：节点ID的值。以节点ID的值作为key，该节点的子节点集合作为value，建立节点之间的关联关系，实现节点的向下遍历。

示例表示：

-客厅

-- 沙发 -- 荼几

-卧室

4.搜索接口（搜索结果跟猜你喜欢的返回参数一样）

http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/list.jsp
测试： http://dev10.pchouse.com.cn:8083/jsp/intf/list.jsp

请求方式：GET

是否需要登录：否

功能说明：根据条件获取产品列表

提交参数：

type: 1
q: 沙发,红色
pageNo: 1
pageSize: 50
scope: 1
sort:1

提交参数说明：

type: 1为查询主题,2为查询产品。0为混合查询。 q: 关键字(必须以utf-8编码提交，多个关键字用英文逗号隔开)
pageNo: 页码
pageSize: 分页大小
scope: 搜索范围 1只搜商品名称含有关键字的 2只搜索类别 3只搜索属性 4只搜索品牌 5搜索商品名称、类别、属性、品牌;默认为1
sort:1为按最新排序，2最热排序，3为最优惠排序

返回参数：

{
    "total":100,
    "pageNo":1,
    "pageSize":10,
    "items":[
        {
            "type": 1
            "id": 1
            "name":"天猫双十二真情回馈专题",
            "src":"http://"
        },
        {
            "type": 2
            "id": 1
            "name":"法丽莎家具 欧式床 实木床 田园婚床 双人床 1.8 1.5米",
            "price":"￥2699.00",
            "price2":"￥2000.00",
            "src": "http://",
            "favorite":1234
        }
    ]
}

返回参数说明：
total：单品总数量
pageNo：分页用页码
pageSize：分页用每页数量
items: 搜索结果数组

type: 1为主题 2为产品 name：type为1时，是主题名；type为2时，是产品名
price：产品原价,仅当type为2时生效
price2: 折后价(可能为空)，仅当type为2时生效
favorite：收藏数量
src: 图片(无须区分主题、产品) 注意：如果src是upc.pchouse.com.cn的话，尺寸规则用upc的。

5.测试页

http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/test.jsp
测试： http://dev10.pchouse.com.cn:8083/jsp/intf/test.jsp

请求方式：GET

是否需要登录：否

功能说明：返回最新的测试页面内容。

一个测试会分解成若干个测试题组，每个测试题组包含一个或多个测试题目。每个测试题组能够测试出用户的一个特征。该用户特征决定了后续题组的加载顺序
一个测试题目可以包含多个回答选项，测试题目的回答选项只能进行单选。
网友在答题过程中，只能单向的前进或者后退，不能进行跳跃。在进行回退时，能够从当前的题目，一直退回到测试的开始题目。这种回退可能会跨越多个题组
网友在答题过程中，能够放弃答题。
客户端需要记录网友答题的位置，在网友切换APP时，能够回到上次未完成的答题位置。

提交参数：无

返回参数：

[
    {
        "$group-id": {
		    "type":"single",		
            "topics": [
                {
                    "topic-seq": 1,
                    "topic-desc": "",
                    "topic-img": "",
                    "options": [{"option-seq": 1,"option-desc": ""},
                                {"option-seq": 1,"option-desc": ""}]
                },
                {
                    "topic-seq": 2,
                    "topic-desc": "",
                    "topic-img": "",
                    "options": [{"option-seq": 1,"option-desc": ""},
                                {"option-seq": 1,"option-desc": ""}]
                }
            ],
            "relates": [{"1,2": "3"},{"1,3": "5"}]
        }
    },
    {
        "$group-id": {
		    "type":"percentage",
            "topics": [
                {
                    "topic-seq": 1,
                    "topic-desc": "",                    
                    "percentage":30,
                    "options": [{"option-seq": 1,"options-img": "","option-desc": "","traits":"古典"},
                                {"option-seq": 2,"options-img": "","option-desc": "","traits":"现代"}]
                },
                {
                    "topic-seq": 2,
                    "topic-desc": "",
		    "percentage":50,					
                    "options": [{"option-seq": 1,"options-img": "","option-desc": "","traits":"古典"},
                                {"option-seq": 2,"options-img": "","option-desc": "","traits":"现代"}]
                }
            ]
        }
    }
]

返回参数说明：
$group-id：测试题组的ID，一个测试题组可以包含一个或多个测试题
type：single 或者 percentage，当type=single时，表示该测试题组是单选，并且会给出完成此题组后，加载下一个题组的对应规则。如果该题组回答完成后，

无条件的跳转到后继题组，用 "relates": [{"*": "3"}] 表示。
type=percentage时，该题组仅仅出现在最后一个，类型为percentage的题组，回答完成后得到的是一个用户特征的百分比集合，例如{"现代":70},{"简约":30}

topics：测试题组下面的测试题数组，存放了该测试题组的具体测试题目。
topic-seq：一个测试题组中，测试题目的顺序
topic-desc：测试题目的描述
options：测试题目的选项数组。
option-seq：一个测试题目对应的选项的顺序号
options-img:一个测试题目对应的选项的图片。[[BR]] option-desc：一个测试题目对应的选项的描述。
relates：完成一个测试题组下题目的测试后，根据测试结果会判别出用户的一些特征，根据这些特征，系统在加载后续题组时会有所不同

这个数组就存放了这种对应关系。这个数组的每个元素表示一种用户特征和后继题组的对应关系。数字元素的【key】表示了网友
参与了当前题组的测试结果，【value】表示了测试题组的ID。测试结果是该测试题组下，每个答题选项，按照题目顺序拼接的一个字符串，该字符串用','分隔。

6.测试结果记录（弃用）

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/testRecord.jsp
测试： http://dev10.pchouse.com.cn:8083/jsp/intf/testRecord.jsp

请求方式：POST

是否需要登录：是

功能说明：登录后记录用户测试的内容

提交参数：

common_session_id：common_session_id。
type：single 或者 percentage。
traits：当type=single时，该字段表示提交的网友在测试过程中，最后一个测试题所标识的用户特征。 如果type=percentage时，该字段表示一个用户特征的百分比集合，例如{"现代":70},{"简约":30} 。

返回参数：

7.终端页

http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/product.jsp
测试： http://dev10.pchouse.com.cn:8083/jsp/intf/product.jsp

请求方式：GET

是否需要登录：否

功能说明：根据产品id，返回产品的详细信息

提交参数：

id：产品id
common_session_id:common_session_id

返回参数：

{
    "name":"法丽莎家具 欧式床 实木床 田园婚床 双人床 1.8 1.5米",
    "price":"￥2699.00",
    "pric2":"￥2000.00",
    "nick":"发丽莎家居旗舰店",
    "picUrl":"http://xxxx",
    "src":"http://xxxx",
    "detailUrl":"http://",
    "mobileUrl":"http://",
    "isCollected":0,
    "freight": 1,
    "invoice": 1,
    "lightning": -1,
    "warranty": -1,
    "image":[
        { src: "http://xxxx", isManual: 1 },
        { src: "http://xxxx", isManual: 1 },
        { src: "http://xxxx", isManual: 0 }
    ],
    "favorite": 123,
    "p1": 1000,
    "p2": 100,
    "p3": 200,
    "p4": 1200
}

返回参数说明：
name：产品名
price:原价
price2：折后价
nick：商家名称
picUrl: 商品淘宝封面注意，已弃用，请使用src
src: 商品封面注意：如果src是upc.pchouse.com.cn的话，尺寸规则用upc的。
detailUrl: 淘宝终端页
mobileUrl: 淘宝手机版终端页
image：图片数组
图片组信息： src: 图片地址， isManual: 图片是否手动提交（1为手动提交，0为通过爬取接口自动获取）注意：如果src是upc.pchouse.com.cn的话，尺寸规则用upc的。
isCollected:是否已经被收藏了，1为是，0为否,common_session_id为空时，isCollected=0
freight: 是否包邮 1 是 -1 否 begin at app2.0
invoice: 是否有发票 1 是 -1 否 begin at app2.0
lightning: 是否闪电发货 1 是 -1 否 begin at app2.0,
warranty: 是否保修 1 是 -1 否 begin at app2.0,
p1: 原价begin at app2.0,
p2: 优惠价（可无）begin at app2.0,
p3: 优惠最高价（可无）begin at app2.0,
p4: 原价最高价（可无）begin at app2.0,

8.用户信息

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/user.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/user.jsp

请求方式：GET

是否需要登录：是

功能说明：登录后，返回用户信息

提交参数：

"common_session_id":"xxxxx"

提交参数说明：
common_session_id: common_session_id

返回参数：

http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/
{
    "id": 1,
    "nick":"imoveto1",
    "status": 1,
    "face":"http://xxx",
    "sign":"坚持世上一切美好的事物，哈哈！",
    "favoriteCount":34,
    "recordCount":134,
    "commonSessionId": "",
    "favoriteUpdate": 1
}

id: 优品用户id
nick：用户呢称
commonSessionId：common_session_id
status：用户状态 -1为禁用 1为正常
sign：备注
face：头像
favoriteCount：收藏夹数量
recordCount：浏览历史
favoriteUpdate: 收藏夹内是否有商品优惠 1 是 0 否 begin at app2.0

注意：用户信息可能包含换行符，统一将 \r\n 转换为 [-n-] 和 \n 转换为 [-n-]

9.用户信息修改接口

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/user_edit.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/user_edit.jsp

请求方式：POST

是否需要登录：是

功能说明：修改用户信息接口

提交参数：

nick：呢称
common_session_id: common_session_id
userid：用户id
sign：个性签名
face：头像
isPush：是否接收降价推送（1为接收，-1为不接收，默认为1）

返回参数：

result：返回代码,
msg：返回信息

10.登录接口（可以是分成3个URL）

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://dev1.pchouse.com.cn/passport2/api/open_oauth.jsp?type=sina_house&return=http://youpin.pchouse.com.cn/jsp/intf/bind.jsp&bind_url=http://youpin.pchouse.com.cn/jsp/intf/unbind.jsp?printMsg=true

请求方式：POST

功能说明：已新浪微博，腾讯微博，淘宝账号登录

提交参数：

type：区分新浪微博(sina_house_youpin)，腾讯微博(qzone_house_youpin)，淘宝账号(taobao_house_youpin)
return: 登录逻辑处理 
bind_url: 绑定逻辑处理

登录成功，跳转到 http://youpin.pchouse.com.cn/jsp/intf/bind.jsp(测试: http://dev10.pchouse.com.cn:8083/jsp/intf/bind.jsp)，并且header带有返回参数：

nick: 用户名称 
face: 用户头像 
sign: 用户个性签名 
passportId: 用户passportId 
commonSessionId: common_session_id 
favoriteCount：收藏数
recordCount：浏览记录数
openInfo：{
    qzone_house：qzone的json信息
    sina_house：sina的json信息
}

sina的json包含以下信息：
"sina_house":{
"id":***,
"createTime":***,
"token":"XXX",
"accountId":***,
"openAccountId":"XXX",
"consumerId":***,
"expiresIn":"XXX",
"updateTime":***,
"code":"XXX"
}

注意：用户信息可能包含换行符，统一将 \r\n 转换为 [-n-] 和 \n 转换为 [-n-]

11.注销接口(已弃用，不需要web端做接口，APP端直接提交注销请求到passport即可)

URL： http://passport2.pcgames.com.cn/passport2/passport/logout.jsp[[BR]] 提交参数：

common_session_id：session值

12.收藏接口

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/favorite.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/favorite.jsp

请求方式：POST

是否需要登录：是

功能说明：登录后记录用户收藏的内容

提交参数：

  common_session_id：common_session_id,
  productId: 商品ID,
  favoriteTime : 收藏时间

返回参数：

  result：返回代码,
  msg：返回信息

13.收藏列表

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/user_favorite.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/user_favorite.jsp

请求方式：GET

是否需要登录：是

功能说明：登录后显示用户收藏的内容

提交参数：

common_session_id：common_session_id

返回参数：

{
    "userId": 1,
    "userName":"XXX",
    "products": [
        {
            "id": 2203,
            "name": "田园布艺沙发 sj002abc",
            "src": "http://xxx",
            "link": "http://xxx",
            "mobileLink":"http://xxx",
            "price": 998.00,
            "price2": 998.00,
            "favorite": 523,
            "favoriteTime": XXXX-XX-XX,
            "lastPrice": 200,
            "status": 1
        },
        {
            "id": 2204,
            "name": "田园布艺沙发 sj002abc123",
            "src": "http://xxx",
            "link": "http://xxx",
            "mobileLink":"http://xxx",
            "price": 998.00,
            "price2": 998.00,
            "favorite": 52,
            "favoriteTime": XXXX-XX-XX,
            "lastPrice": 200,
            "status": 1
        }
    ]
}

userId: 用户id
userName: 用户昵称
products: 产品列表
id: 产品id
name: 产品名
src: 产品图片地址
link: 产品链接
mobileLink: 淘宝手机终端页
price: 价格
price2: 折扣价
favorite: 收藏数
favoriteTime: 收藏时间
lastPrice: 最后查看收藏商品的最低价格 app2.0
status: 1正常 -1商品被设为不通过 9下架 8已经删除

14.浏览记录

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/record.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/record.jsp

请求方式：POST

是否需要登录：是

功能说明：发送用户浏览过的产品

提交参数：

common_session_id：common_session_id
productId：产品id
macId: mac地址
tTime: 停留时间
vTime: 浏览时间
enterFrom: 入口标识, 1列表页,2搜索页,3猜你喜欢页,4主题,5收藏记录,6浏览历史,7优惠列表，8推送、9订阅列表，10相关推荐，11广告，51web家居集，52web主题，53web我的优品，54web订阅页面，56web搜索

返回参数：

15.搜索(已弃置,请使用4.搜索接口)

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL：

请求方式：POST

是否需要登录：否

功能说明：根据条件搜索，已分页形式返回产品列表

提交参数：

返回参数：

16.发送评论

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/comment.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/comment.jsp

请求方式：POST

是否需要登录：都可以

功能说明：用户发送评论信息

提交参数：

情况1：没有登录
productId：产品Id
content：用户评论内容

情况2：已经登录
common_session_id：登录信息字符串
productId：产品Id
content：用户评论内容
is_incognito：用户是否匿名评论，1，表示用户是选择匿名评论；-1，表示用户是选择记录用户信息的评论

返回参数：

17.获取评论（视情况而定，是否在页面终端页中加入）

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/get_comment.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/get_comment.jsp

请求方式：GET

是否需要登录：否

功能说明：根据主题id，已分页形式返回产品列表

提交参数：

productId：产品Id
pageNo:页码
pageSize:分页大小

返回参数：

{
    "total":100,
    "pageNo":1,
    "pageSize":10,
    "comments":[
        {
            "nickName":"b_小贝贝",
            "time":"9月3日 15:23",
            "face":"http://asdfasdf",
            "content":"她家的包包看起来还不错，有谁买过的，求推荐！"
        },
        {
            "nickName":"Blanch_213",
            "time":"9月3日 15:53",
            "face":"http://asdfasdf",
            "content":"简单，但太普遍了！"
        }
    ]
}

total：主题总数量
pageNo：分页用页码
pageSize：分页用每页数量
nickName: 用户昵称 time：评论时间 face：用户头像 content：评论内容

18.获取浏览记录

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/user_record.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/user_record.jsp

请求方式：GET

是否需要登录：是

功能说明：获取用户浏览过的产品信息

提交参数：

common_session_id：common_session_id

返回参数：

{
    userId: 1,
    userName: "aaaaaaaaa",
    products: [
        {
            id: 5,
            name: "包邮宜家田园草编藤编抽柜床头柜简约地柜储物柜收纳柜斗柜带里衬",
            src: "http://XXX",
            link: "http://XXX",
            "mobileLink":"http://xxx",
            vTime: XXXX-XX-XX,
            tTime: 2152450
        },
        {
            id: 6,
            name: "包邮宜家田园草编藤编抽柜床头柜简约地柜储物柜收纳柜斗柜带里衬",
            src: "http://XXX",
            link: "http://XXX",
            "mobileLink":"http://xxx",
            vTime: XXXX-XX-XX,
            tTime: 2152450
        }
    ]
}

userId: 用户id
userName: 用户昵称
products: 产品列表
id: 产品id
name: 产品名
src: 产品图片地址
link: 产品链接
mobileLink: 淘宝手机终端页
vTime: 浏览时间
tTime: 停留时间

19.获取测试记录

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/user_testrecord.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/user_testrecord.jsp

请求方式：GET

是否需要登录：是

功能说明：获取用户测试信息

提交参数：

common_session_id：common_session_id
pageNo:页码
pageSize:分页大小

返回参数：

{
    "total":100,
    "pageNo":1,
    "pageSize":10,
    "items":[
        {
            "type": 1
            "id": 1
            "name":"天猫双十二真情回馈专题",
            "src":"http://"
        },
        {
            "type": 2
            "id": 1
            "name":"法丽莎家具 欧式床 实木床 田园婚床 双人床 1.8 1.5米",
            "price":"￥2699.00",
            "price2":"￥2000.00",
            "src": "http://",
            "favorite":1234
        }
    ]
}

返回参数说明：
total：单品总数量
pageNo：分页用页码
pageSize：分页用每页数量
items: 搜索结果数组
type: 1为主题 2为产品 name：type为1时，是主题名；type为2时，是产品名
price：产品原价,仅当type为2时生效
price2: 折后价(可能为空)，仅当type为2时生效
favorite：收藏数量
src: 图片(无须区分主题、产品)

20.猜你喜欢

http://youpin.pchouse.com.cn/jsp/intf/user_test.jsp?record=0&macId=test1&optionId=319&testTime=2012-11-14&common_session_id=xxxx

请求方式：POST

是否需要登录：是

功能说明：猜你喜欢

提交参数：

common_session_id：common_session_id，没登录时不需要发送
record:   1为需要写入服务器，0为不需要
macId:mac地址
optionId：选项id1，选项id2，选项id3
testTime：测试时间

返回参数：

21.删除浏览记录

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/
URL:http://youpin.pchouse.com.cn/jsp/intf/del_record.jsp[[BR]]

URL：

请求方式：POST

是否需要登录：是

功能说明：发送用户删除的浏览记录

提交参数：

common_session_id：common_session_id
productIds: 商品ID1,商品ID2，商品ID3

返回参数：

  result：返回代码,
  msg：返回信息

22.删除收藏接口

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/del_favorite.jsp[[BR]]

请求方式：POST

是否需要登录：是

功能说明：用户删除收藏的产品

提交参数：

  common_session_id：common_session_id,
  productIds: 商品ID1,商品ID2，商品ID3

返回参数：

  result：返回代码,
  msg：返回信息

23.记录点击购买链接接口

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/user_buy.jsp

请求方式：POST

是否需要登录：是

功能说明：记录用户点击购买的产品

提交参数：

  common_session_id：common_session_id,
  id: 商品id

返回参数：

  result：返回代码,
  msg：返回信息

24.搜索接口2 app2.0

http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/list2.jsp
测试： http://dev10.pchouse.com.cn:8083/jsp/intf/list2.jsp

请求方式：GET

是否需要登录：否

功能说明：根据条件获取产品列表

提交参数：

category:1
brand:诗雅轩家具旗舰店
style:1
service:2
pageNo: 1
pageSize: 50
sort:1
limitPrice:1

提交参数说明：

category: 类别
brand: 品牌
style: 风格
material: 材质
service: 服务
price: 价格

注意：参数的命名，新增修改在后台的自定义查询管理中设置。另外参数的获取通过 http://youpin.pchouse.com.cn/jsp/intf/condition2.jsp 接口获取

pageNo: 页码
pageSize: 分页大小
sort:1为按最新排序，2最大折扣 3最大差价 4热门
limitPrice: 只用于优惠页面，参数传值为1。

返回参数：

{
    "total":100,
    "pageNo":1,
    "pageSize":10,
    "items":[
        {
            "id": 1,
            "status": 1,
            "name":"法丽莎家具 欧式床 实木床 田园婚床 双人床 1.8 1.5米",
            "price":"￥2699.00",
            "price2":"￥2000.00",
            "src": "http://",
            "favorite":1234,
            "disparity": 89.4,
            "discount": 2
        }
    ]
}

返回参数说明：
total：单品总数量
pageNo：分页用页码
pageSize：分页用每页数量
items: 搜索结果数组

name：产品名
status: 产品状态，1为正常，非1为已下架
price：产品原价,仅当type为2时生效
price2: 折后价(可能为空)，仅当type为2时生效
favorite：收藏数量
src: 图片(无须区分主题、产品) 注意：如果src是upc.pchouse.com.cn的话，尺寸规则用upc的。
disparity: price减去price2得出的差价
discount: price2乘以10再除以price得出的折扣

25.收藏主题接口 app2.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/theme_favorite.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/theme_favorite.jsp

请求方式：POST

是否需要登录：是

功能说明：登录后记录用户收藏的主题内容信息

提交参数：

  common_session_id：common_session_id,
  themeId: 主题ID

返回参数：

  result：返回代码,
  msg：返回信息

26.收藏主题列表 app2.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/user_theme_favorite.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/user_theme_favorite.jsp

请求方式：GET

是否需要登录：是

功能说明：登录后显示用户收藏的主题内容信息

提交参数：

common_session_id：common_session_id

返回参数：

{
  userId: 1,
  userName: "XXX",
  themes: [
  {
    id: 54,
    name: "简约宜家风 小空间的扩容魔法",
    logo: "http://img.pconline.com.cn/images/upload/upc/tx/house_youpin/1212/13/c0/16577515_16577515_1355392730531.jpg",
    status: 1,
    intro: "宜家风格近年来越来越为大家所喜爱,房子装修基本用都是宜家风格家具,因为宜家简约而清新,时尚却实用,宜家家居的设计风格,总是让人满意。小空间、大容纳，很好的选择。",
    favorite: 1
  },
  {
    id: 64,
    name: "周末特卖场 千元以内置家精明选",
    logo: "",
    status: -1,
    intro: "00",
    favorite: 1
  }
  ]
}

userId: 用户id
userName: 用户昵称
themes: 主题列表
id: 主题id
name: 主题名
logo: 主题封面图
status：主题状态（1：可用 -1：不可用）
intro：主题描述
favorite: 收藏数

27.删除主题收藏接口 app2.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/del_theme_favorite.jsp[[BR]]

请求方式：POST

是否需要登录：是

功能说明：用户删除收藏的主题

提交参数：

  common_session_id：common_session_id,
  themeIds: 主题ID1,主题ID2，主题ID3

返回参数：

  result：返回代码,
  msg：返回信息

28.用户启动应用记录接口 app2.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/v2.0.0/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/startup.jsp

请求方式：POST

是否需要登录：否

功能说明：记录用户启动应用接口

提交参数：

    userId: 123

返回参数：

  result：返回代码,
  msg：返回信息

29.主题浏览记录接口 app2.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/theme_record.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/theme_record.jsp

请求方式：POST

是否需要登录：是

功能说明：登录后记录用户浏览的主题内容信息

提交参数：

  common_session_id：common_session_id,
  themeId: 主题ID,
  tTime：一共停留的时间

返回参数：

  result：返回代码,
  msg：返回信息

30.主题浏览记录列表 app2.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/user_theme_record.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/user_theme_record.jsp

请求方式：GET

是否需要登录：是

功能说明：登录后显示用户收藏的主题内容信息

提交参数：

common_session_id：common_session_id

返回参数：

{
  userId: 1,
  userName: "XXX",
  themes: [
  {
    id: 54,
    name: "简约宜家风 小空间的扩容魔法",
    logo: "http://img.pconline.com.cn/images/upload/upc/tx/house_youpin/1212/13/c0/16577515_16577515_1355392730531.jpg",
    status: 1,
    intro: "宜家风格近年来越来越为大家所喜爱,房子装修基本用都是宜家风格家具,因为宜家简约而清新,时尚却实用,宜家家居的设计风格,总是让人满意。小空间、大容纳，很好的选择。",
    favorite: 1
  },
  {
    id: 64,
    name: "周末特卖场 千元以内置家精明选",
    logo: "",
    status: -1,
    intro: "00",
    favorite: 1
  }
  ]
}

31.删除主题浏览记录接口 app2.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/del_theme_record.jsp[[BR]]

请求方式：POST

是否需要登录：是

功能说明：用户删除浏览的主题信息

提交参数：

  common_session_id：common_session_id,
  themeIds: 主题ID1,主题ID2，主题ID3

返回参数：

  result：返回代码,
  msg：返回信息

32.相关推荐产品接口 app2.0

http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/recommend.jsp
测试： http://dev10.pchouse.com.cn:8083/jsp/intf/recommend.jsp

请求方式：GET

是否需要登录：否

功能说明：根据某产品对应的大类及风格获取相关推荐产品列表

提交参数：

productId:1
pageNo: 1
pageSize: 50

提交参数说明：
productId: 产品ID
pageNo: 页码
pageSize: 分页大小

返回参数：

{
    "total":100,
    "pageNo":1,
    "pageSize":10,
    "items":[
        {
            "id": 1
            "name":"法丽莎家具 欧式床 实木床 田园婚床 双人床 1.8 1.5米",
            "price":"￥2699.00",
            "price2":"￥2000.00",
            "src": "http://",
            "favorite":1234
        }
    ]
}

返回参数说明：
total：单品总数量
pageNo：分页用页码
pageSize：分页用每页数量
items: 相关推荐数组

name：产品名
price：产品原价,仅当type为2时生效
price2: 折后价(可能为空)，仅当type为2时生效
favorite：收藏数量
src: 图片注意：如果src是upc.pchouse.com.cn的话，尺寸规则用upc的。

33.新增修改订阅接口 app2.0

http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/user_subscribe.jsp

请求方式：POST

是否需要登录：是

功能说明：用户新增修改订阅

提交参数：

common_session_id: xxxx
id: 2
category:101
brand:诗雅轩家具旗舰店
style:316
material:365
service:2
price:30,1000

提交参数说明：
common_session_id: common_session_id
id: 非必选，用户修改订阅时，带上id。新增时没有id
category: 类别ID,多个类别用逗号隔开
brand: 品牌,多个品牌用逗号隔开
style: 风格ID,多个风格用逗号隔开
material: 材质ID,多个材质用逗号隔开
service: 服务ID,多个服务用逗号隔开
price: 价格,多个价格用逗号隔开

注意：条件必须至少提交一个过来

返回参数：

{
    "result": 1,
    "msg" : "订阅成功"
}

返回参数说明：
result：1 订阅成功 -1 订阅不成功
msg：返回信息

34.设置订阅顺序接口 app2.0

http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/set_user_subscribe_order.jsp

请求方式：POST

是否需要登录：是

功能说明：设置订阅顺序

提交参数：

common_session_id: xxxx
id: 1,3,4
seq: 1,2,5

提交参数说明：
common_session_id: common_session_id
id: 订阅的id，多个用逗号隔开 seq: 订阅的顺序，多个用逗号隔开

注意：必须保证id跟seq的数目一致。

返回参数：

{
    "result": 1,
    ""msg: "设置订阅顺序成功"
}

返回参数说明：
result：1 订阅顺序设置成功 -1 订阅顺序设置失败
msg：返回信息

35.获取订阅列表 app2.0

http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/user_subscribe_list.jsp

请求方式：GET

是否需要登录：是

功能说明：获取用户订阅列表

提交参数：

common_session_id: xxxx
pageNo: 1
pageSize: 20

提交参数说明：
common_session_id: common_session_id
pageNo: 分页
pageSize: 分页大小

返回参数：

{
    "result": 1,
    "msg": "获取订阅列表成功", 
    "pageNo": 1,
    "pageSize": 20,
    "total": 50,
    "subscribes": [
       {
          "id": 1,
          "category_id": 2,
          "categoryName": "沙发",
          "styles": 2,3,
          "stylesName": "田园,中式",
          "minPrice": 100,
          "maxPrice": 1000,
          "headProducts": [{"id": 47139, "name":"欧式 头等舱沙发 真皮沙发客厅 头层牛皮多功能单人电动影院沙发", "logo":"http://img04.taobaocdn.com/bao/uploaded/i4/T1TdrrXhVgXXXJQGja_120122.jpg"}, {}],
          "seq": 1,
          "hasUpdate": 1
        },
    ]
}

返回参数说明：
result：1 获取订阅列表成功 -1 获取订阅列表失败
msg：返回信息
pageNo：分页
pageSize：分页大小
total：订阅总数
subscribes：订阅列表

id：订阅的id
category_id：类别id
categoryName：类别名称
styles：多个风格id
stylesName：多个风格名称
minPrice：最低价
minPrice：最高价
headProducts：前三个产品
seq：序号
hasUpdate：是否有商品更新1是 -1否

36.获取订阅内容 app2.0

http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/get_user_subscribe.jsp

请求方式：POST

是否需要登录：是

功能说明：获取订阅内容

提交参数：

common_session_id: xxxx
id: 1
pageNo: 1
pageSize: 20

提交参数说明：
common_session_id: common_session_id
id: 订阅的id
pageNo: 分页
pageSize: 分页大小

返回参数：

{
    "result": 1,
    "msg": "获取成功", 
    "pageNo": 1,
    "pageSize": 20,
    "total": 50,
    "products": [
        {
            "id": 1
            "name":"法丽莎家具 欧式床 实木床 田园婚床 双人床 1.8 1.5米",
            "price":"￥2699.00",
            "price2":"￥2000.00",
            "src": "http://",
            "favorite":1234
        }
    ]
}

返回参数说明：
result：1 获取订阅内容成功 -1 获取订阅内容失败
msg：返回信息
pageNo：分页
pageSize：分页大小
total：关联的产品总数
products：商品列表

id：商品的id
name：商品名称
price：原价
price2：优惠价
src：封面
favorite：收藏数

37.删除订阅 app2.0

http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/delete_user_subscribe.jsp

请求方式：POST

是否需要登录：是

功能说明：用户删除

提交参数：

common_session_id: xxxx
id: 1

提交参数说明：
common_session_id: common_session_id
id: 订阅的id

返回参数：

{
    "result": 1,
    "msg": "删除订阅成功" 
}

返回参数说明：
result：1删除成功 -1 删除失败
msg：返回信息

38.动态条件接口 app2.0

http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/condition.jsp
测试： http://dev10.pchouse.com.cn:8083/jsp/intf/condition.jsp

请求方式：GET

是否需要登录：否

功能说明：根据用户输入的条件动态变化搜索条件

提交参数：

categoryId:1
brands:诗雅轩家具旗舰店
styles:1
services:2
pageNo: 1
pageSize: 50
sort:1

提交参数说明：
categoryId: 类别ID
brands: 多个品牌
styles: 多个风格
services: 多个服务
pageNo: 页码
pageSize: 分页大小
sort:1为按最新排序，2最热排序，3为最优惠排序

返回参数：

{
    "brands":[
       "优尚美家旗舰店","雷博士红楼专卖店","美迪雅家居旗舰店"..................
    ],
    "categorys":[
        {
           "id": 101,
           "name": "客厅",
           "children":[
               {
                  "id":212,
                  "name":"沙发",
                  "children":[........]  
               }
           ]
        },
        {
           "id": 102,
           "name": "卧室",
           "children":[
               {
                  "id":222,
                  "name":"床",
                  "children":[........]  
               }
           ]
        },
        ...............
     ],
    "styles":[
        {
            "id": 316,
            "name":"欧式"
        },
        {
            "id": 317,
            "name":"田园"
        },
        ...............
    ],
    "services":[
        {
            "id": 1,
            "name":"是否包邮"
        },
        {
            "id": 2,
            "name":"是否有发票"
        },
        ............
    ],
    "price":{
         "min" : 200,
         "max" : 8000
     }

返回参数说明：

brands: 品牌数组

categorys: 分类数组

id: 风格ID
name:风格名称
children: 分类子结果

styles: 风格结果数组

id:风格ID
name:风格名称

services: 服务结果数组

id:服务ID
name:服务名称

price: 价格

min: 最低价格
max: 最高价格

39.更新用户最后查看收藏商品的价格 app2.0

http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/user_favorite_price.jsp

请求方式：POST

是否需要登录：是

功能说明：更新用户最后查看收藏商品的价格

提交参数：

common_session_id: xxxx
productId: 1

提交参数说明：
common_session_id: common_session_id
productId: 商品id

返回参数：

{
    "result": 1
}

返回参数说明：
result：1更新成功

40.动态条件接口2 app2.0

http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/condition2.jsp
测试： http://dev10.pchouse.com.cn:8083/jsp/intf/condition2.jsp

请求方式：GET

是否需要登录：否

功能说明：根据用户输入的条件动态变化搜索条件

提交参数：

category:101
brand:诗雅轩家具旗舰店
style:316
material:365
service:2
price:30,1000
pageNo: 1
pageSize: 50
sort:1

提交参数说明：
category: 类别ID,多个类别用逗号隔开
brand: 品牌,多个品牌用逗号隔开
style: 风格ID,多个风格用逗号隔开
material: 材质ID,多个材质用逗号隔开
service: 服务ID,多个服务用逗号隔开
price: 价格,多个价格用逗号隔开

price只能传两个数字，并且前面的数字要少于后面的数字

注意：参数的命名，新增修改在后台的自定义查询管理中设置。另外参数的获取通过 http://youpin.pchouse.com.cn/jsp/intf/condition2.jsp 接口获取
pageNo: 页码
pageSize: 分页大小
sort:1为按最新排序，2最热排序，3为最优惠排序

返回参数：

{
	"result": 1,
	"items": [
		{
			"id": 5,
			"type": 1,
			"name": "category",
			"display": "分类",
			"seq": 1,
			"level": 2,
			"options": [
				{
					"display": "客厅",
					"value": 12,
					"options": [
						{
							"display": "沙发",
							"value": 23
						}
					]
				},
				{
					"display": "儿童房",
					"value": 46,
					"options": [
						{
							"display": "儿童桌",
							"value": 78
						}
					]
				}
			]
		},
		{
			"id": 8,
			"type": 2,
			"name": "style",
			"display": "风格",
			"seq": 2,
			"level": 1,
			"options": [
				{
					"display": "中式",
					"value": 55
				},
				{
					"display": "欧美",
					"value": 25
				}
				
			]
		},
		{
			"id": 8,
			"type": 2,
			"name": "material",
			"display": "材质",
			"seq": 4,
			"level": 1,
			"options": [
				{
					"display": "中式",
					"value": 55
				},
				{
					"display": "欧美",
					"value": 25
				}
				
			]
		},
		{
			"id": 8,
			"type": 2,
			"name": "service",
			"display": "服务",
			"seq": 5,
			"level": 1,
			"options": [
				{
					"display": "中式",
					"value": 55
				},
				{
					"display": "欧美",
					"value": 25
				}
				
			]
		},
		{
			"id": 9,
			"type": 3,
			"name": "price",
			"display": "价格",
			"seq": 3,
			"min": 200,
			"max": 5000,
			"level": 1,
			"options": [
				{
					"display": "0",
					"value": 0
				},
				{
					"display": "100",
					"value": 100
				},
				{
					"display": "500",
					"value": 500
				},
				{
					"display": "900",
					"value": 900
				},
				{
					"display": "1300",
					"value": 1300
				}
			]
		}
	]
	
}

返回参数说明：
items:

id: 查询ID
type: 查询类型 1为单选 2为多选 3为价格区间
name: 参数名称
display: 显示名称
seq: 排序
level: 级别
min:最低价格只有type为3才有
max:最高价格只有type为3才有
options: 选项数组

display:显示名称
value:具体值
options: 子选项数组

display:显示名称
value:具体值

41.根据关键字搜索产品接口 app2.0

http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/search.jsp
测试： http://dev10.pchouse.com.cn:8083/jsp/intf/search.jsp

请求方式：GET

是否需要登录：否

功能说明：根据关键字搜索产品列表

提交参数：

q:"沙发"
pageNo: 1
pageSize: 50

提交参数说明：

q: 关键字
pageNo: 页码
pageSize: 分页大小

返回参数：

{
    "total":100,
    "pageNo":1,
    "pageSize":10,
    "items":[
        {
            "id": 1
            "name":"天猫双十二真情回馈专题",
            "src":"http://"
        },
        {
            "id": 1
            "name":"法丽莎家具 欧式床 实木床 田园婚床 双人床 1.8 1.5米",
            "price":"￥2699.00",
            "price2":"￥2000.00",
            "src": "http://",
            "favorite":1234,
            "discount": 74,
            "disparity":699
        }
    ]
}

返回参数说明：
total：单品总数量
pageNo：分页用页码
pageSize：分页用每页数量
items: 搜索结果数组

name：产品名
price：产品原价
price2: 折后价(可能为空)
favorite：收藏数量
src:图片(无须区分主题、产品) 注意：如果src是upc.pchouse.com.cn的话，尺寸规则用upc的。
discount:price2除于price(折扣）
disparity: price减去price2得出的差价

42.app广告列表接口 app2.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/list_advert.jsp
测试： http://dev10.pchouse.com.cn:8083/jsp/intf/list_advert.jsp

请求方式：GET

是否需要登录：否

功能说明：搜索广告，已分页形式返回

提交参数：

     "pageNo": 1
     "pageSize": 5

提交参数说明：
pageNo: 分页页码（默认为1）
pageSize: 分页大小（默认为5）

返回参数：

{
    total: 3,
    pageNo: 1,
    pageSize: 5,
    advert: [
        {
            id: 4,
            logo: "http://img.pconline.com.cn/images/upload/upc/tx/house_youpin/1301/23/c0/17641861_17641861_1358908459752.jpg",
            logo2: "http://img.pconline.com.cn/images/upload/upc/tx/house_youpin/1301/23/c0/17641888_17641888_1358908471334.jpg",
            type: 4,
            url: "",
            targetId: 11,
            seq: 1
        },
        {
            id: 5,
            logo: "http://img.pconline.com.cn/images/upload/upc/tx/house_youpin/1301/23/c0/17642008_17642008_1358908530481.jpg",
            logo2: "http://img.pconline.com.cn/images/upload/upc/tx/house_youpin/1301/23/c0/17642020_17642020_1358908544331.jpg",
            type: 3,
            url: "",
            targetId: 8888,
            seq: 2
        },
        {
            id: 6,
            logo: "http://img.pconline.com.cn/images/upload/upc/tx/house_youpin/1301/23/c0/17642033_17642033_1358908590881.jpg",
            logo2: "http://img.pconline.com.cn/images/upload/upc/tx/house_youpin/1301/23/c0/17642046_17642046_1358908605552.jpg",
            type: 1,
            url: "http://www.pconline.com.cn/",
            targetId: 0,
            seq: 3
        }
    ]
}

返回参数说明：
total：主题总数量
pageNo：分页用页码
pageSize：分页用每页数量
advert：广告数组
id：广告的id
logo：广告iphone4图片
logo2：广告iphone5图片
type：广告跳转类型（1为指定地址 2为appstore 3为商品 4为主题）
url：跳转地址
targetId：跳转商品或主题id
seq：排序值

43.更新用户token接口

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/update_user_token.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/update_user_token.jsp

请求方式：POST

是否需要登录：否

功能说明：用于魔方拓展接口接收数据

提交参数：

  二进制的压缩包

返回参数：

  HTTPSQS_PUT_ERROR:接收错误
  HTTPSQS_PUT_OK:接收正常

44.更新用户token接口2

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/update_user_token2.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/update_user_token2.jsp

请求方式：POST

是否需要登录：是

功能说明：登录后更新用户的token

提交参数：

  common_session_id:验证用户是否登录
  token：用户授权token

返回参数：

  result：返回代码"1"，表示更新成功

45.新浪和QQ的SSO登陆接口

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/sso_login.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/sso_login.jsp

请求方式：POST

是否需要登录：否

功能说明：提供新浪和QQ的SSO登陆

提交参数：

  type：app编号
  token：用户授权token
  open_account_id：用户第三方帐号ID

返回参数：

  status：处理状态(0为成功,其它为失败)
  desc：处理结果描述
  id：passportId(当成功时才返回)
  common_session_id1：登录cookie(当成功时才返回)
  user：用户对象信息(当成功时才返回)

46.根据类别ID获取产品信息

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/get_product_by_category_id.jsp
测试： http://dev10.pchouse.com.cn:8083/jsp/intf/get_product_by_category_id.jsp

请求方式：GET

是否需要登录：否

功能说明：根据类别ID获取产品信息

提交参数：

     "pageNo": 1
     "pageSize": 10
     "categoryId"：13
     "callback"：test
     "orderBy"：1

提交参数说明：
pageNo: 分页页码（默认为1）
pageSize: 分页大小（默认为10）
categoryId：类别ID
callback：如有值 callback 回调
orderBy：排序(默认为1)
返回参数：

{
total: 13331,
pageNo: 1,
pageSize: 1,
data: [
{
	id: 37852,
	name: "琪琪家园 简约电视柜 钢化玻璃伸缩烤漆白色创意电视地柜包邮588",
	price: "1680.00",
	price2: "999.00",
	price3: "0.00",
	price4: "0.00",
	url: "http://zhoulingxin.pchouse.com.cn:8092/item/37852.html",
	img1: "http://img03.taobaocdn.com/bao/uploaded/i3/T19ejcXeRhXXbFJe2a_121020.jpg_100x100.jpg",
	img2: "http://img03.taobaocdn.com/bao/uploaded/i3/T19ejcXeRhXXbFJe2a_121020.jpg_120x120.jpg",
	img3: "http://img03.taobaocdn.com/bao/uploaded/i3/T19ejcXeRhXXbFJe2a_121020.jpg_160x160.jpg",
	img4: "http://img03.taobaocdn.com/bao/uploaded/i3/T19ejcXeRhXXbFJe2a_121020.jpg_200x200.jpg",
	img5: "http://img03.taobaocdn.com/bao/uploaded/i3/T19ejcXeRhXXbFJe2a_121020.jpg_240x240.jpg",
	favorite_count: 24,
	comment_count: 20,
	options: [
		{
		id: 319,
		tagName: "简约现代",
		tagUrl: "http://zhoulingxin.pchouse.com.cn:8092/jiajuji/j215-f319.html"
		}
	]
}
]
}

返回参数说明：
total：主题总数量
pageNo：分页用页码
pageSize：分页用每页数量
id：产品ID
name：产品名称
price：产品价格
price2：产品价格2
price3：产品价格3
price4：产品价格4
url：跳转地址
img1：产品图片100x100
img2：产品图片120x120
img3：产品图片160x160
img4：产品图片200x200
img5：产品图片240x240
favorite_count：产品收藏数量
comment_count：产品评论数量
tagName：产品标签
tagUrl：标签跳转地址

47.根据产品ID获取产品信息

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.0/

URL： http://youpin.pchouse.com.cn/jsp/intf/get_product_by_id.jsp
测试： http://dev10.pchouse.com.cn:8083/jsp/intf/get_product_by_id.jsp

请求方式：GET

是否需要登录：否

功能说明：根据产品ID获取产品信息

提交参数：

	 "id"：13
	 "callback"：test

提交参数说明：
id：产品ID
callback：如有值 callback 回调
返回参数：

test(
{
data: [
{
	id: 57048,
	name: "Acina欧式化妆台 实木梳妆台 案台 半圆桌 实木玄关台LF836",
	price: "3184.72起",
	url: "http://zhoulingxin.pchouse.com.cn:8092/item/57048.html",
	status: 1,
	img1: "http://img01.taobaocdn.com/bao/uploaded/i1/362791498/T2ItFGXkJaXXXXXXXX_!!362791498.jpg_600x600.jpg",
	img2: "http://img01.taobaocdn.com/bao/uploaded/i1/362791498/T2ItFGXkJaXXXXXXXX_!!362791498.jpg_300x300.jpg"
	}
	]
}
)

返回参数说明：
id：产品ID
name：产品名称
price：产品价格
url：跳转地址
status：产品状态
img1：产品图片600x600
img2：产品图片300x300

48.典型案例接口 app3.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/get_typicalCase_by_id.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/get_typicalCase_by_id.jsp

请求方式：GET

是否需要登录：否

功能说明：获取典型案例内容信息

提交参数：

  id: 典型案例ID

返回参数：

{
	data: [
	{
			"id":1,
			"name":"case name",
			"tag":"tag message",
			"status":1,
                        "favorite": 1,(1代表已收藏，-1代表没有收藏，0代表没有登录)
			"src":"http://......",
			"source":1,
			"userId":1,
			"resume":"resume message",
			"items":[
				{
					"id": 1,
					"type": 1,(1为商品)
					"targetId":123456,
					"img":"产品图片200x200",
					"price":"￥208.60",
					"tag": "描述tag",
					"resume": "描述"
				},
				{...},{...}
			]
		]
	}
}

49.典型案例获取评论接口 app3.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/get_typicalCase_comment.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/get_typicalCase_comment.jsp

请求方式：GET

是否需要登录：否

功能说明：获取典型案例评论内容信息

提交参数：

  caseId: 典型案例ID

返回参数：

{
    "total":100,
    "pageNo":1,
    "pageSize":10,
    "comments":[
        {
            "id": 1,
            "passport_id": 1,
            "nickName":"name message",
            "face":"http://asdfasdf",
            "content":"comment content",
            "commentTime":"20XX-XX-XX",
            "STATUS": 1
        },
        {...},{...}
    ]
}

50.发送评论（典型案例） app3.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/typicalCase_comment.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/typicalCase_comment.jsp

请求方式：POST

是否需要登录：都可以

功能说明：用户发送评论信息

提交参数：

情况1：没有登录
caseId: 典型案例ID
content：用户评论内容

情况2：已经登录
common_session_id：登录信息字符串
caseId: 典型案例ID
content：用户评论内容
is_incognito：用户是否匿名评论，1，表示用户是选择匿名评论；-1，表示用户是选择记录用户信息的评论

返回参数：

{
  result：返回代码,(1：成功)
  msg：返回信息
}

51.收藏/取消收藏典型案例接口 app3.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/user_case_favorite.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/user_case_favorite.jsp

请求方式：POST

是否需要登录：是

功能说明：登录后记录用户收藏的典型案例内容信息

提交参数：

  common_session_id：common_session_id,
  caseId: 典型案例ID
  type: 类型(1为收藏案例,-1为取消收藏案例)

返回参数：

{
  result：返回代码,(1：成功)
  msg：返回信息
}

52.记录推送打开接口 app3.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/push_open.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/push_open.jsp

请求方式：POST

是否需要登录：都可以

功能说明：记录用户打开推送操作

提交参数：

  pushId: 推送ID

返回参数：

{
  result：返回代码,(1：成功)
  msg：返回信息
}

53.获取主题和搭配接口 app3.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/get_theme_and_case.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/get_theme_and_case.jsp

请求方式：任意

是否需要登录：不需要

功能说明：获取主题和搭配的信息

提交参数：

  pageNo: 分页页码（默认为1）[[BR]]
  pageSize: 分页大小（默认为20）

返回参数：

{
  total: 147,
  pageNo: 1,
  pageSize: 20,
  items: [
  {
    id: 1,
    type: 2,
    name: "test1",
    url: "",
    intro: "测试测试测试"
  }
  ...
  ]
}

返回参数说明：
total：主题和搭配的总数
pageNo: 分页页码（默认为1）
pageSize: 分页大小（默认为20）
id：主题或搭配的ID
type：1表示主题，2表示搭配
name：主题或搭配的名字
url：主题或搭配的图片url
intro：主题或搭配的描述

54.获取用户收藏典型案例接口 app3.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/get_user_case_favorite.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/get_user_case_favorite.jsp

请求方式：GET

是否需要登录：否

功能说明：获取用户所有收藏的典型案例内容信息

提交参数：

  session

返回参数：

{
	userId: 11355,
	userName: "小新",
	total: 3,
	pageNo: 1,
	pageSize: 20,
	data: [
	{
			"id":1,
			"name":"case name",
			"tag":"tag message",
			"status":1,
			"src":"http://......",
			"source":1,
			"userId":1,
			"resume":"resume message",
			"items":[
				{
					"id": 1,
					"type": 1,
					"targetId":123456,
					"img":"产品图片200x200",
					"price":"￥208.60",
					"tag": "描述tag",
					"resume": "描述"
				},
				{...},{...}
			]
		]
	}
}

55.APP获取搜索产品结果的接口 app3.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/search_filter.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/search_filter.jsp

请求方式：GET

是否需要登录：否

功能说明：获取搜索结果的产品内容信息

提交参数：

  pageNo: 分页页码（默认为1）[[BR]]
  pageSize: 分页大小（默认为20）[[BR]]
  type: 搜索类型（1为快搜，2为类别，3为ID）[[BR]]
  name: 搜索条件名称[[BR]]
  value: 搜索条件值

返回参数：

{
	data: {
		pageNo: 1,
		pageSize: 20,
		total: 4162,
		items: [
			{
			id: 103557,
			status: 1,
			p1: "32550.00",
			p2: "32550.00",
			p3: "34550.00",
			p4: "34550.00",
			name: "全实木雕刻沙发 商城正品特价 高端客厅家具 真皮沙发 厂家直销",
			price: "32550.00",
			create: "2013-03-02 00:55:54",
			price2: "32550.00",
			favorite: 0,
			src: "http://img02.taobaocdn.com/bao/uploaded/i2/17264019273929214/T1rm7VXg8cXXXXXXXX_!!0-item_pic.jpg",
			discount: 100,
			disparity: 0
			}
			{...}...{...}
		]
	}
}

56.获取市下拉内容接口 app3.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/get_area.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/get_area.jsp

请求方式：GET[BR]]

是否需要登录：否

功能说明：获取市下拉内容

提交参数：

  provinceId: 省ID[[BR]]

返回参数：

{
	├和平区: 120101,
	├河东区: 120102,
	├河西区: 120103,
	├南开区: 120104,
	├河北区: 120105,
	├红桥区: 120106
}

57.根据地域名获取配送内容接口 app3.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/get_delivery.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/get_delivery.jsp

请求方式：GET[BR]]

是否需要登录：否

功能说明：获取配送内容

提交参数：

  pro: 省名[[BR]]
  city: 市名[[BR]]

返回参数：

[
	{
	id: 2,
	name: "测试2",
	provinceName: "广东省",
	cityName: "广州市",
	url: "http://www.pchouse.com.cn"
	}
]

58.获取最新的商品(分家具家饰)内容接口 app3.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/get_new_product.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/get_new_product.jsp

请求方式：GET[BR]]

是否需要登录：否

功能说明：获取最新商品内容

提交参数：

  type: 类别（1为家具，2为家饰）[[BR]]
  pageNo: 分页页码（默认为1）[[BR]]
  pageSize: 分页大小（默认为12）[[BR]]

返回参数：

{
	total: 15491,
	pageNo: 1,
	pageSize: 12,
	data: [
		{
		name: "家立方收纳 600D牛津布收纳箱 大号衣服储物箱整理箱 玩具杂物箱",
		price: "￥59起",
		img_120: "http://img.pconline.com.cn/images/upload/upc/tx/house_youpin/1310/28/c1/28067059_1382962126531_120x120.jpg"
		},
	...
	]
}

59.根据ID获取主题内容接口 app3.0

原型 http://trac.pc.com.cn/mobile/pototype/ideas/youjiapin/req1.0.1/

URL： http://youpin.pchouse.com.cn/jsp/intf/get_theme_by_ids.jsp
测试: http://dev10.pchouse.com.cn:8083/jsp/intf/get_theme_by_ids.jsp

请求方式：GET[BR]]

是否需要登录：否

功能说明：根据ID获取主题内容

提交参数：

  ids: 主题id（有多个ID时用逗号分开）[[BR]]

返回参数：

{
	data: [
		{
		id: 511,
		name2: "秋秋秋来",
		name3: "快来给床选个秋衣",
		logo: "http://img.pconline.com.cn/images/upload/upc/tx/house_youpin/1309/15/c0/25723931_25723931_1379255672785.jpg",
		intro: "大街小巷里的人儿都换上了秋衣秋裤，淡淡的秋意来了，你有没有feel到呢？在抵御秋凉的同时，别忘了给你家的床也换上“秋装”。金黄、咖啡色等色彩延续着流行热度，成为今秋主角，而传统的红、橙等暖色调也依然吸引着人我们的眼球。"
		},
		{
		id: 512,
		name2: "ABc",
		name3: "再忙也要和家人过节",
		logo: "http://img.pconline.com.cn/images/upload/upc/tx/house_youpin/1309/15/c0/25723963_25723963_1379255721990.jpg",
		intro: "今年中秋节终于到来了，在这样家庭团圆的日子里，再忙也要和家人过节，赶紧回家一起吃个团圆饭吧！在这样的时刻，置身庄重与清雅并存的中式餐厅，再合适不过了！"
		}
	]
}

用户行为接口

家居优品项目希望通过对用户一些行为的收集，分析和识别出用户的一些特征。系统利用用户特征，能够较为准确的给网友进行商品推荐。系统主要对下列

用户的行为进行采集：搜索关键词、测试结果关键词、浏览商品、浏览主题、收藏商品。其中浏览商品和浏览主题的信息保存在客户端上，需要客户端提交给服务器，其余信息在网友操作过程中，服务器能够自动采集。

浏览商品

采集频率：实时提交
数据格式：[{"mac-id":"004443fdd433434","uid":"233223","pid":"xxxxx","t-time":233]

mac-id:网卡的mac地址，必须提交。[[BR]] uid:登录用户的ID，未登录时为空。[[BR]] pid:商品ID[[BR]] v-time:商品页停留时间=离开商品终端页的时间 - 进入商品终端页的时间；单位是秒,毫秒尾数进行四舍五入。

存储方式：数据库

浏览主题

采集频率：实时提交
数据格式：[{"mac-id":"004443fdd433434","uid":"233223","tid":"xxxxx","t-time":2323}]

mac-id:网卡的mac地址，必须提交。[[BR]] uid:登录用户的ID，未登录时为空。[[BR]] tid:商品ID[[BR]] v-time:主题页停留时间=离开主题页的时间 - 进入主题页的时间；单位是秒,毫秒尾数进行四舍五入。

存储方式：数据库

Attachments

模板顺序.doc (168.5 KB) - added by hejingdong 13 years ago.
测试模板对应编号.doc (2.3 MB) - added by huozhenhua 13 years ago.

Download in other formats:

Plain Text

Context Navigation

基本约定

1.首页接口---主题列表

2.主题接口

3.单品库首页

示例表示：

4.搜索接口（搜索结果跟猜你喜欢的返回参数一样）

5.测试页

6.测试结果记录 （弃用）

7.终端页

8.用户信息

9.用户信息修改接口

10.登录接口（可以是分成3个URL）

11.注销接口(已弃用，不需要web端做接口，APP端直接提交注销请求到passport即可)

12.收藏接口

13.收藏列表

14.浏览记录

15.搜索(已弃置,请使用4.搜索接口)

16.发送评论

17.获取评论（视情况而定，是否在页面终端页中加入）

18.获取浏览记录

19.获取测试记录

20.猜你喜欢

21.删除浏览记录

22.删除收藏接口

23.记录点击购买链接接口

24.搜索接口2 app2.0

25.收藏主题接口 app2.0

26.收藏主题列表 app2.0

27.删除主题收藏接口 app2.0

28.用户启动应用记录接口 app2.0

29.主题浏览记录接口 app2.0

30.主题浏览记录列表 app2.0

31.删除主题浏览记录接口 app2.0

32.相关推荐产品接口 app2.0

33.新增修改订阅接口 app2.0

34.设置订阅顺序接口 app2.0

35.获取订阅列表 app2.0

36.获取订阅内容 app2.0

37.删除订阅 app2.0

38.动态条件接口 app2.0

39.更新用户最后查看收藏商品的价格 app2.0

40.动态条件接口2 app2.0

41.根据关键字搜索产品接口 app2.0

42.app广告列表接口 app2.0

43.更新用户token接口

44.更新用户token接口2

45.新浪和QQ的SSO登陆接口

46.根据类别ID获取产品信息

47.根据产品ID获取产品信息

48.典型案例接口 app3.0

49.典型案例获取评论接口 app3.0

50.发送评论（典型案例） app3.0

51.收藏/取消收藏典型案例接口 app3.0

52.记录推送打开接口 app3.0

53.获取主题和搭配接口 app3.0

54.获取用户收藏典型案例接口 app3.0

55.APP获取搜索产品结果的接口 app3.0

56.获取市下拉内容接口 app3.0

57.根据地域名获取配送内容接口 app3.0

58.获取最新的商品(分家具家饰)内容接口 app3.0

59.根据ID获取主题内容接口 app3.0

用户行为接口

Attachments

Download in other formats:

6.测试结果记录（弃用）