Changes between Version 12 and Version 13 of price_api_2.3.0


Ignore:
Timestamp:
12/15/2015 11:14:15 AM (10 years ago)
Author:
oujianqiang
Comment:

--

Legend:

Unmodified
Added
Removed
Modified
  • price_api_2.3.0

    v12 v13  
    6666**mrobot接口** 
    6767> http://mrobot.pconline.com.cn/s-300/best/cms/listHomepage.xsp  [[BR]] 
    68 eg: http://mrobot.pconline.com.cn/s-300/best/cms/listHomepage.xsp?pageNo=1&pageSize=10&v=2.3.0&platform=iOS&inReview=0 [[BR]] 
     68eg: http://mrobot.pconline.com.cn/s-300/best/cms/listHomepage.xsp?pageNo=1&pageSize=10&v=2.3.0&platform=ios&inReview=0 [[BR]] 
    6969 
    7070**后端接口** 
    7171> 首页精选数据接口:http://best.pconline.com.cn/app/facade/cache/index.do?pageNo=1&pageSize=20 [[BR]] 
    72 > 焦点图:http://best.pconline.com.cn/app/focus/cache/listFocus.do?topicTypeId=0&type=0&v=2.3.0&platform=iOS&inReview=0 [[BR]] 
     72> 焦点图:http://best.pconline.com.cn/app/focus/cache/listFocus.do?topicTypeId=0&type=0&v=2.3.0&platform=ios&inReview=0 [[BR]] 
    7373 
    7474**后端接口文档** 
     
    119119            url: "http://a.c.com/1.do",  // pc端焦点图跳转url,ps:该字段有数据时才显示,无数据时不显示 
    120120            createAt: 136521542140000,  // 创建时间 
    121             isOfficialPurchasing: 0  //0不支持官方代购,1支持官方代购【V2.2.0需求:新增字段】 
     121            isOfficialPurchasing: 0  //0不支持官方代购,1支持官方代购    2.2.0新增 
    122122        } 
    123123        ... 
     
    144144                hdCover: "http://www.google.com/1_hd.png",  // 高清图,适用于晒物,经验,试用体验 
    145145                showPicForApp: 1,  // 是否白菜价合集 
    146                 isOfficialPurchasing: 0  //0不支持官方代购,1支持官方代购【V2.2.0需求:新增字段】 
     146                isOfficialPurchasing: 0  //0不支持官方代购,1支持官方代购 
    147147            } 
    148148        } 
     
    2002001)sectionId=100[后端已支持]时,请求属于“一键购”的海淘列表数据。 
    201201 
    202 2、新增3个筛选条件的参数: 
    203 1)电商商城; 
    204 2)当前热点; 
    205 3)精彩推荐; 
    206  
    207 3、新增3个用于控制的参数(无论是get请求还是post请求,都在url上加) 
     2022、新增3个用于控制的参数(无论是get请求还是post请求,都在url上加) 
    2082031)platform:平台,传”ios”或”android”; 
    2092042)v:app版本号,如2.3.0; 
     
    226221 
    227222> http://mrobot.pconline.com.cn/s-300/best/cms/getTopicList.xsp 
    228 eg:http://mrobot.pconline.com.cn/s-300/best/cms/getTopicList.xsp?sectionId=0&pageNo=2&pageSize=20&v=2.3.0&platform=iOS&inReview=0 [[BR]] 
     223eg:http://mrobot.pconline.com.cn/s-300/best/cms/getTopicList.xsp?sectionId=0&pageNo=2&pageSize=20&v=2.3.0&platform=ios&inReview=0 [[BR]] 
    229224 
    230225**后端接口** 
     
    259254||pageNo||页数||int||1||是|||| 
    260255||pageSize||页面大小||int||10||是|||| 
    261 ||v||版本号||int||0||否||2.3.0版本传v=2.3.0|| 
    262 ||inReview||审核状态||int||0||否||1-是,0-不是|| 
     256||v||版本号||int||0||是||2.3.0版本传v=2.3.0|| 
     257||platform||审核状态||string||”ios”||是||传”ios”或”android”|| 
     258||inReview||审核状态||int||0||iOS必填,Android不填||1-是,0-不是|| 
    263259 
    264260**返回格式** 
     
    297293            createName: "Jason@qq.com",  // 创建者名称 
    298294            createNamePrefix: "Jason",  // 创建者名称,邮箱前缀 
    299             isOfficialPurchasing: 0  //0不支持官方代购,1支持官方代购【V2.2.0需求:新增字段】 
     295            isOfficialPurchasing: 0  //0不支持官方代购,1支持官方代购    2.2.0新增 
     296            bestBuyLink: "http://item.yhd.com/item/50997527?tracker_u=105608137586",   //【去看看】链接    2.3.0新增 
     297            artUrl: "http://best.pconline.com.cn/haitao/178445.html",       //用于分享的链点    2.3.0新增 
     298            synopsis: "买买买买买买买买买买买买买买买买买买...",           //爆料简介     2.3.0新增 
     299            wxTitle: "【聚超值_优惠】飞利浦无线蓝牙音箱   118元包邮",  //用于分享的标题     2.3.0新增 
     300            firstPic: "http://imgrt.pconline.com.cn/images/upload/upc/tx/pc_best/1512/15/c0/spcgroup/qua_30/16475689_1450145374855_350x350.jpg",  //用于分享的图片     2.3.0新增 
    300301        } 
    301302        ... 
     
    313314 
    314315**需求:**[[BR]] 
    315 新接口[[BR]] 
     316{{{ 
     317新接口 
     318返回数据顺序为:电商商城(商城),当前热点(标签),精彩推荐(分类) 
     319}}} 
     320 
    316321 
    317322**mrobot接口** 
     
    321326**后端接口** 
    322327 
    323 > 待补充 
     328> http://best.pconline.com.cn/app/topic/faxian/cache/screen.do 
    324329 
    325330**后端接口文档** 
    326331 
    327 > 待补充 
     332> [http://rdtrac.pc.com.cn/pc_best/wiki/app_01_2_faxian#获取发现筛选条件 获取发现筛选条件] 
    328333 
    329334**说明** 
     
    347352||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| 
    348353||v||版本号||int||0||否||2.3.0版本传v=2.3.0|| 
     354||platform||审核状态||string||”ios”||是||传”ios”或”android”|| 
     355||inReview||审核状态||int||0||iOS必填,Android不填||1-是,0-不是|| 
    349356 
    350357**返回格式** 
     
    353360**返回数据** 
    354361 
     362{{{#!java 
     363{ 
     364    status: 1, 
     365    msg: "请求成功", 
     366    data:[ 
     367        {//from $topic 
     368            title: "电商商城", //筛选条件名称 
     369            type: 1,          // 1 电商   2 标签  3 分类 
     370            screens: [{$mall}, ... or {$tag}, ... or {$topicType}, ...]  // 根据type判断这里是什么类型 
     371        } 
     372        ... 
     373    ] 
     374} 
     375}}} 
    355376>  
    356377 
     378[http://rdtrac.pc.com.cn/pc_best/wiki/app2.0/object_properties#%E5%8F%91%E7%8E%B0%E7%88%86%E6%96%99%E7%AD%9B%E9%80%89%E6%9D%A1%E4%BB%B6VO $topicFaxianScreenVo] 
    357379 
    358380---------- 
    359381 
    360 === 1.4 搜索接口(M) ===  
     382 
     383=== 1.4 发现列表(M) === 
     384(未完成)[[BR]] 
     385 
     386**需求:**[[BR]] 
     387新接口[[BR]] 
     388 
     389 
     390**mrobot接口** 
     391 
     392> (待补充) 
     393eg:http://mrobot.pconline.com.cn/xxx(待补充) [[BR]] 
     394 
     395**后端接口** 
     396 
     397> http://best.pconline.com.cn/app/topic/faxian/cache/getTopicList.do 
     398eg:http://best.pconline.com.cn/app/topic/faxian/cache/getTopicList.do?pageNo=0&pageSize=20&v=2.3.0&platform=ios&inReview=0 [[BR]] 
     399 
     400**后端接口文档** 
     401 
     402> [http://rdtrac.pc.com.cn/pc_best/wiki/app_01_2_faxian#获取发现爆料 获取发现爆料] 
     403 
     404**说明** 
     405 
     406> 获取符合筛选条件的发现列表数据 
     407 
     408**缓存时间** 
     409 
     410> 300s 
     411 
     412**提交方式** 
     413 
     414> GET 
     415 
     416**是否需要登录** 
     417 
     418> 否 
     419 
     420**参数** 
     421 
     422||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| 
     423||sectionId||栏目id:0 优惠 1 海淘 2 发现 3 晒物 4 经验 ||int||0||是|||| 
     424||pageNo||页数||int||1||是|||| 
     425||pageSize||页面大小||int||10||是|||| 
     426||mallId||电商id||int||0||否|||| 
     427||tagId||标签id||int||0||否|||| 
     428||typeId||类别id||int||0||否|||| 
     429||v||版本号||int||0||是||2.3.0版本传v=2.3.0|| 
     430||platform||审核状态||string||”ios”||是||传”ios”或”android”|| 
     431||inReview||审核状态||int||0||iOS必填,Android不填||1-是,0-不是|| 
     432 
     433mallId  电商id    int     0       否 
     434tagId   标签id    int     0       否 
     435typeId  类别id    int     0       否 
     436 
     437**返回格式** 
     438> json 
     439 
     440**返回数据** 
     441 
     442{{{#!java 
     443{ 
     444    status: 1, 
     445    msg: "请求成功", 
     446    pageNo: 1, 
     447    pageSize: 20, 
     448    pageTotal: 2168, 
     449    total: 43357 
     450    data:[ 
     451        {//from $topic 
     452            topicId: 2395585, 
     453            title: "有钱你就来",  //标题 
     454            shortTitle: "超值商品推荐"  // 短标题 
     455            section: 1, // 栏目:0 优惠  1 海淘  2 发现 3 晒物  4 经验  5 海淘晒物  6 海淘经验  7 试用体验  8 专题 
     456            topSection: 1  // 顶级的栏目id:0优惠,1海淘,2 发现,3 晒物,4经验 
     457            mallName: "京东",  // 电商名称 
     458            mallId: 1, // 电商id 
     459            price: "五折对低价199",  // 价格描述 
     460            pubDate: 13215412512000,  // 发布时间,时间戳 毫秒 
     461            overdueStatus: 1,  // 是否过期 
     462            endTime: 13251245121000,  // 优惠截止时间 
     463            channelId: 12,  // 计数器栏目id 
     464            imagesForList: "http://www.a.b/a.png", 
     465            hasCoupon: 0,  // 是否有优惠券,适用于 优惠,海淘 
     466            cover: "http://www.google.com/1.png", 
     467            hdCover: "http://www.google.com/1_hd.png",  // 高清图,适用于晒物,经验,试用体验 
     468            showPicForApp: 1  // 是否白菜价合集 
     469            createName: "Jason@qq.com",  // 创建者名称 
     470            createNamePrefix: "Jason",  // 创建者名称,邮箱前缀 
     471            isOfficialPurchasing: 0  //0不支持官方代购,1支持官方代购     2.2.0新增 
     472            bestBuyLink: "http://item.yhd.com/item/50997527?tracker_u=105608137586",   //【去看看】链接    2.3.0新增 
     473            artUrl: "http://best.pconline.com.cn/haitao/178445.html",       //用于分享的链点    2.3.0新增 
     474            synopsis: "买买买买买买买买买买买买买买买买买买...",           //爆料简介     2.3.0新增 
     475            wxTitle: "【聚超值_优惠】飞利浦无线蓝牙音箱   118元包邮",  //用于分享的标题     2.3.0新增 
     476            firstPic: "http://imgrt.pconline.com.cn/images/upload/upc/tx/pc_best/1512/15/c0/spcgroup/qua_30/16475689_1450145374855_350x350.jpg",  //用于分享的图片     2.3.0新增 
     477        } 
     478        ... 
     479    ] 
     480} 
     481}}} 
     482 
     483[http://trac.pc.com.cn/pc_best/wiki/app2.0/object_properties#爆料 $topic] 
     484 
     485---------- 
     486 
     487=== 1.5 搜索接口(M) ===  
    361488(未完成)[[BR]] 
    362489 
     
    448575           createName: "Jason@qq.com",  // 创建者名称 
    449576           createNamePrefix: "Jason",  // 创建者名称,邮箱前缀 
    450            isOfficialPurchasing: 0  //0不支持官方代购,1支持官方代购【V2.2.0需求:新增字段】 
     577           isOfficialPurchasing: 0  //0不支持官方代购,1支持官方代购    2.2.0新增 
    451578        }, 
    452579        ... 
     
    469596 
    470597 
    471 === 1.5 爆料详情wap页(M) === 
     598=== 1.6 爆料详情wap页(M) === 
    472599(未完成)[[BR]] 
    473600 
     
    564691  iphoneResVer:21000, //模板版本号(iOS请求时返回) 
    565692  androidResVer:21000, //模板版本号(Android请求时返回) 
    566   isOfficialPurchasing: 0  //0不支持官方代购,1支持官方代购【V2.2.0需求:新增字段】 
     693  isOfficialPurchasing: 0  //0不支持官方代购,1支持官方代购    2.2.0新增 
    567694} 
    568695 
     
    583710  iphoneResVer:21000, //模板版本号(iOS请求时返回) 
    584711  androidResVer:21000, //模板版本号(Android请求时返回) 
    585   isOfficialPurchasing: 0  //0不支持官方代购,1支持官方代购【V2.2.0需求:新增字段】 
     712  isOfficialPurchasing: 0  //0不支持官方代购,1支持官方代购    2.2.0新增 
    586713} 
    587714}}} 
     
    612739 
    613740 
    614 === 1.6 爆料关联的优惠信息(M) === 
     741=== 1.7 爆料关联的优惠信息(M) === 
    615742(未完成)[[BR]] 
    616743 
     
    666793---------- 
    667794 
    668 === 1.7 优惠券列表(M) ===  
     795=== 1.8 优惠券列表(M) ===  
    669796(未完成)[[BR]] 
    670797 
     
    750877---------- 
    751878 
    752 === 1.8 优惠券详情wap页(M) === 
     879=== 1.9 优惠券详情wap页(M) === 
    753880(未完成)[[BR]] 
    754881 
     
    810937---------- 
    811938 
    812 === 1.9 领取优惠券 ===  
     939=== 1.10 领取优惠券 ===  
    813940(未完成)[[BR]] 
    814941 
     
    8731000 
    8741001 
    875 === 1.10 商品选择wap页(M) === 
     1002=== 1.11 商品选择wap页(M) === 
    8761003(未完成)[[BR]] 
    8771004 
     
    9151042||= 参数名 =||= 参数含义 =||= 类型 =||= 默认值 =||= 是否必须 =||= 备注 =|| 
    9161043|| topicId || 爆料id || string || "" || 是 ||  || 
    917 ||v||版本号||int||0||否||2.2.0版本传v=2.2.0|| 
     1044||v||版本号||int||0||否||2.3.0版本传v=2.3.0|| 
    9181045 
    9191046**返回格式** 
     
    9321059 
    9331060 
    934 === 1.11 提交订单 === 
     1061=== 1.12 提交订单 === 
    9351062(未完成)[[BR]] 
    9361063 
     
    10061133 
    10071134 
    1008 === 1.12 订单信息 === 
     1135=== 1.13 订单信息 === 
    10091136(未完成)[[BR]] 
    10101137