Changes between Version 68 and Version 69 of price_api_2.2.0


Ignore:
Timestamp:
11/24/2015 05:43:49 PM (10 years ago)
Author:
oujianqiang
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • price_api_2.2.0

    v68 v69  
    772772 
    773773 
     774=== 1.12 首页列表数据接口(M) ===  
     775**(接口已完成,请连开发机进行测试)**[[BR]] 
     776 
     777**需求:**[[BR]] 
     7781、topic实体新增一个字段 isOfficialPurchasing,用于区分爆料是否支持官方代购;[[BR]] 
     779 
     780>http://mrobot.pconline.com.cn/s-300/best/cms/listHomepage.xsp  [[BR]] 
     781>eg: http://mrobot.pconline.com.cn/s-300/best/cms/listHomepage.xsp?pageNo=1&pageSize=10&v=201 
     782 
     783**后端接口** 
     784 
     785> [http://rdtrac.pc.com.cn/pc_best/wiki/app2.0/facade 首页数据接口] [http://rdtrac.pc.com.cn/pc_best/wiki/app2.0/11_focusImage 焦点图] 
     786> http://best.pconline.com.cn/app/facade/cache/index.do?pageNo=1&pageSize=20 [[BR]] 
     787> http://best.pconline.com.cn/app/focus/cache/listFocus.do?topicTypeId=0&type=0&v=201 
     788**说明** 
     789 
     790> 获取推荐首页列表数据 + 焦点图(另外的接口,当pageNo为1时返回) 
     791 
     792**提交方式** 
     793 
     794> GET 
     795 
     796**参数** 
     797 
     798||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| 
     799||pageNo||页数||int||1||是|| 
     800||pageSize||页面大小||int||10||是|| 
     801||v||版本号||int||0||否|| 
     802 
     803**返回** 
     804 
     805{{{#!java 
     806{ 
     807    status: 1,  
     808    msg: "请求成功", 
     809    pageNo: 1, 
     810    pageSize: 20, 
     811    pageTotal: 2168, 
     812    total: 43357, 
     813    focus: [//焦点图 
     814        {//from $focusImage 
     815     focusImageId: 12, 
     816    typeId: 爆料类型Id 
     817    imageUrl: "http://img.pconline.com.cn/7.jpg",  // 焦点图 
     818    seq: 1, 
     819    positionIndex: 1,  // 0 app端焦点图、1 wap端焦点图、2 pc端首页焦点图、3 pc端海淘焦点图、4 PC端晒货焦点图、5 PC端经验焦点图、6 WAP端首页焦点图、7 wap端海淘焦点图、8 wap端发现焦点图、9 wap端晒物焦点图、10 wap端经验焦点图 
     820    focusTitle: "现货直接买!iPhone6 Plus 64G三网通5K1",  // 标题 
     821    topicId: 125,  // 爆料id 
     822    sectionType: 1  // 顶级的栏目id:0优惠,1海淘,2 发现,3 晒物,4经验 
     823    url: "http://a.c.com/1.do",  // pc端焦点图跳转url,ps:该字段有数据时才显示,无数据时不显示 
     824    createAt: 136521542140000  // 创建时间 
     825        } 
     826        ... 
     827    ] 
     828    listIndex:[ 
     829        { 
     830            type:1 // 1 爆料 
     831            value:{//from $topic 
     832                topicId: 2395585, 
     833                title: "有钱你就来",  //标题 
     834                shortTitle: "超值商品推荐"  // 短标题 
     835                section: 1, // 栏目:0 优惠  1 海淘  2 发现 3 晒物  4 经验  5 海淘晒物  6 海淘经验  7 试用体验  8 专题 
     836                topSection: 1  // 顶级的栏目id:0优惠,1海淘,2 发现,3 晒物,4经验 
     837                mallName: "京东",  // 电商名称 
     838                mallId: 1, // 电商id 
     839                price: "五折对低价199",  // 价格描述 
     840                pubDate: 13215412512000,  // 发布时间,时间戳 毫秒 
     841                overdueStatus: 1,  // 是否过期 
     842                endTime: 13251245121000,  // 优惠截止时间 
     843                channelId: 12,  // 计数器栏目id 
     844                imagesForList: "http://www.a.b/a.png", 
     845                hasCoupon: 0,  // 是否有优惠券,适用于 优惠,海淘 
     846                cover: "http://www.google.com/1.png", 
     847                hdCover: "http://www.google.com/1_hd.png",  // 高清图,适用于晒物,经验,试用体验 
     848                showPicForApp: 1  // 是否白菜价合集 
     849                isOfficialPurchasing: 0  //0不支持官方代购,1支持官方代购【V2.2.0需求:新增字段】 
     850            } 
     851        } 
     852        { 
     853            type:2 // 2 推荐位 
     854            value:{//from $adPosition 
     855                    adId: 51, 
     856                    adTitle: "好东西哇", 
     857                    price: "12块包邮", 
     858                    imageUrl: "http://img.pconline.com.cn/7.jp", 
     859                    topicId: 23412 
     860                    section: 1, // 栏目:0 优惠  1 海淘  2 发现 3 晒物  4 经验  5 海淘晒物  6 海淘经验  7 试用体验  8 专题 
     861                    topSection: 1  // 顶级的栏目id:0优惠,1海淘,2 发现,3 晒物,4经验 
     862                    url: "http://g.pconline.com.cn/a/73727.html",  // 跳转链接 
     863                    urlType: 1,  // 1 爆料  2 网页, 
     864                    seq:3  // 排序,插入到首页的位置 
     865            } 
     866        } 
     867        { 
     868            type:4 // 4 优惠券 
     869            value:{//from $gift 
     870                giftId: 1,  // 礼品Id 
     871                name: "京东卡", 
     872                needScore: 10, //所需积分 
     873                needGold: 2,//所需金币 
     874                mallId:  12,  // 电商Id 
     875                mallName: '京东',  // 电商名称 
     876                imageUrl: "http://a.cn/1.png",  // 图片 
     877                imgPath260x130:"",//260x130图片 
     878                discount: "满400减20",  // 优惠券额度 
     879                createTime: 13251245124000,  // 创建时间 
     880                expiryDate: 13621321521000,  // 有效期 
     881                remainingDay:2  // 当前时间距离优惠券过期的天数 
     882                
     883            } 
     884        } 
     885        ... 
     886    ] 
     887} 
     888}}} 
     889 
     890[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#焦点图 $focusImage] [http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#爆料 $topic] [http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#推荐位 $adPosition] [http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#礼品 $gift]  
     891 
     892---------- 
     893 
     894=== 1.13 搜索接口(M) ===  
     895**(mrobot已完成,请连开发机进行测试)** [[BR]] 
     896 
     897**需求:**[[BR]] 
     8981、topic实体新增一个字段 isOfficialPurchasing,用于区分爆料是否支持官方代购;[[BR]] 
     899 
     900**mrobot接口**: 
     901>http://mrobot.pconline.com.cn/s-300/best/search/listTopicSearch.xsp 
     902 
     903**后端接口** 
     904 
     905> [http://trac.pc.com.cn/pc_best/wiki/app2.0/02_search#搜索接口 搜索接口][[BR]] 
     906> http://best.pconline.com.cn/app/search/listTopicSearch.do 
     907 
     908**说明** 
     909 
     910> 分类搜索返回5个栏目筛选项 国内电商返回 优惠/发现;国外电商返回 海淘/发现 标签搜索返回5个栏目筛选项 关键词搜索返回关键词 + 5个栏目 
     911 
     912**提交方式** 
     913 
     914> GET 
     915 
     916**参数** 
     917 
     918||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =|| 
     919||pageNo||页数||int||1||是|| 
     920||pageSize||页面大小||int||10||是|| 
     921||searchType||1 按分类搜索 2 按电商搜索 3 按标签搜索 4 按关键词搜索||int||4||否|| 
     922||searchCondition||根据searchType传入具体的内容,分类、电商、标签传入对应的id,关键词直接传入搜索的关键词字符串||根据searchType而定:1,对应int, 2(电商名称),3(标签名称),4(关键词)对应String||""||否|| 
     923||sectionId||搜索栏目:0 优惠 1 海淘 2 发现 3 晒物 4 经验||int||不同类型的搜索出不同的默认值(依据app默认显示的栏目)||否|| 
     924 
     925**返回** 
     926 
     927{{{#!java 
     928{ 
     929  status: 1, 
     930  msg: "请求成功", 
     931  pageNo: 1, 
     932  pageSize: 20, 
     933  total: 100, 
     934  data: { 
     935    topics: [ 
     936        {//from $topic 
     937           topicId: 2395585, 
     938           title: "有钱你就来",  //标题 
     939           shortTitle: "超值商品推荐"  // 短标题 
     940           section: 1, // 栏目:0 优惠  1 海淘  2 发现 3 晒物  4 经验  5 海淘晒物  6 海淘经验  7 试用体验  8 专题 
     941           topSection: 1  // 顶级的栏目id:0优惠,1海淘,2 发现,3 晒物,4经验 
     942           mallName: "京东",  // 电商名称 
     943           mallId: 1, // 电商id 
     944           price: "五折对低价199",  // 价格描述 
     945           pubDate: 13215412512000,  // 发布时间,时间戳 毫秒 
     946           overdueStatus: 1,  // 是否过期 
     947           endTime: 13251245121000,  // 优惠截止时间 
     948           channelId: 12,  // 计数器栏目id 
     949           imagesForList: ["http://www.a.b/a.png"], 
     950           hasCoupon: 0,  // 是否有优惠券,适用于 优惠,海淘 
     951           cover: "http://www.google.com/1.png", 
     952           hdCover: "http://www.google.com/1_hd.png",  // 高清图,适用于晒物,经验,试用体验 
     953           showPicForApp: 1  // 是否白菜价合集 
     954           createName: "Jason@qq.com",  // 创建者名称 
     955           createNamePrefix: "Jason",  // 创建者名称,邮箱前缀 
     956           isOfficialPurchasing: 0  //0不支持官方代购,1支持官方代购【V2.2.0需求:新增字段】 
     957        }, 
     958        ... 
     959    ], 
     960    searchSectionResults: [ 
     961        {// from $sectionExtend 
     962            value: 1, 
     963            name: '海淘', 
     964            count: 12   
     965        }, 
     966        ... 
     967    ] 
     968  } 
     969} 
     970}}} 
     971[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#爆料 $topic] 
     972[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#栏目搜索结果 $sectionExtend] 
     973 
     974---------- 
     975 
     976 
    774977== 2 地址管理 == 
    775978=== 2.1添加收货地址 ===