| | 1 | == 车型库项目接口 == |
| | 2 | |
| | 3 | === 目录 === |
| | 4 | 1. [#point100 开发时间,负责人及进度汇报 ] |
| | 5 | |
| | 6 | 2. [#point200 mrobot的接口 ] |
| | 7 | |
| | 8 | 2.1 [#point201 产品终端页报价 ] |
| | 9 | |
| | 10 | 2.2 [#point202 产品终端页网上比价 ] |
| | 11 | |
| | 12 | 2.3 [#point203 产品终端页概述 ] |
| | 13 | |
| | 14 | 2.4 [#point204 产品终端页报参数] |
| | 15 | |
| | 16 | 2.5 [#point205 产品对比页 ] |
| | 17 | |
| | 18 | 2.6 [#point206 请求产品资讯 ] |
| | 19 | |
| | 20 | 2.7 [#point207 某产品类型的品牌列表 ] |
| | 21 | |
| | 22 | 2.8 [#point208 产品列表 ] |
| | 23 | |
| | 24 | 2.9 [#point209 产品点评界面 ] |
| | 25 | |
| | 26 | 2.10 [#point210 产品发送评论 ] |
| | 27 | |
| | 28 | 2.11 [#point211 搜索产品(品牌分类统计) ] |
| | 29 | |
| | 30 | 2.12 [#point212 搜索产品(产品结果列表)] |
| | 31 | |
| | 32 | 2.13 [#point213 产品搜索热点推荐 ] |
| | 33 | |
| | 34 | 2.14 [#point214 产品首页 ] |
| | 35 | |
| | 36 | |
| | 37 | 3. [#point300 配合的接口(产品库接口及编辑出的接口) ] |
| | 38 | |
| | 39 | 3.1 [#point301 产品终端页网上比价 ] |
| | 40 | |
| | 41 | 3.2 [#point302 产品资讯接口 ] |
| | 42 | |
| | 43 | 3.3 [#point303 某产品类型的品牌列表 ] |
| | 44 | |
| | 45 | 3.4 [#point304 产品发送评论 ] |
| | 46 | |
| | 47 | 3.5 [#point305 显示分类排名前三的品牌 ] |
| | 48 | |
| | 49 | 3.6 [#point306 产品搜索热点推荐(编辑出) ] |
| | 50 | |
| | 51 | 3.7 [#point307 推荐品牌(编辑出) ] |
| | 52 | |
| | 53 | |
| | 54 | 4. [#point400 测试环境接口配置 ] |
| | 55 | |
| | 56 | 5. [#point500 修改历史 ] |
| | 57 | |
| | 58 | == 1. [=#point100 开发时间,负责人及进度汇报 ]== |
| | 59 | |
| | 60 | ||批次||= 页面 =||= 涉及MROBOT接口 =||=是否需要[[BR]]HTML切图 =||= 需配合的接口负责人[[BR]]及进度 =||= 接口开发[[BR]]预计时间 =||=接口进度(百分比)=||=接口实际[[BR]]完成时间=||=接口确认=|| |
| | 61 | ||第一批|| 产品库首页 || 2.14 [#point214 产品首页 ] ||- || 3.5 [#point305 显示分类排名前三的品牌名字] [[BR]]郑华聪 袁火青 || 8/2 || 0% || 接口实际完成时间 || 接口确认 |
| | 62 | ||第一批|| 品牌列表 || 2.7 [#point207 某产品类型的品牌列表 ] [[BR]]2.12 [#point212 搜索产品(产品结果列表)] ||- || 3.3 [#point302 某产品类型的品牌列表] [[BR]] 3.7 [#point307 推荐品牌(编辑出)][[BR]]郑华聪 袁火青 || 8/2 || 0% || 接口实际完成时间 || 接口确认 |
| | 63 | ||第二批|| 产品列表 || 2.8 [#point208 产品列表 ] ||- || - || 8/2 || 0% || 接口实际完成时间 || 接口确认 |
| | 64 | ||第二批|| 概述(对比浮层) || 2.3 [#point203 产品终端页概述 ] ||是 || - || 8/3 || 0% || 接口实际完成时间 || 接口确认 |
| | 65 | ||第二批|| 参数 || 2.4 [#point204 产品终端页参数 ] ||是 || - || 8/3 || 0% || 接口实际完成时间 || 接口确认 |
| | 66 | ||第二批|| 报价 || 2.1 [#point201 产品终端页报价 ] ||是 || - || 8/6 || 0% || 接口实际完成时间 || 接口确认 |
| | 67 | ||第二批|| 图片(图片列表/展示) || 以前的接口 || - || - || - || -|| - || - |
| | 68 | ||第二批|| 资讯(文章页) || 2.6 [#point206 请求产品资讯 ] ||是 || 3.2 [#point302 产品资讯接口] [[BR]]郑华聪 袁火青 || 8/6 || 0% || 接口实际完成时间 || 接口确认 |
| | 69 | ||第二批|| 点评(我要点评) || 2.9 [#point209 产品点评界面 ] ||是|| - || 8/6 || 0% || 接口实际完成时间 || 接口确认 |
| | 70 | ||第二批|| 网上比价 || 2.2 [#point202 产品终端页网上比价 ] ||是 || 3.1 [#point301 产品终端页网上比价][[BR]] 黄忠 || 8/6 || 0% || 接口实际完成时间 || 接口确认 |
| | 71 | ||第二批|| 选择城市 || 以前的接口 || - || - || - || -|| - || - |
| | 72 | ||第三批|| 对比结果 || 2.5 [#point205 产品对比页 ] ||是 || - || 8/7 || 0% || 接口实际完成时间 || 接口确认 |
| | 73 | ||第三批|| 选机2页面 || 以前的接口 || - || - || - || -|| - || - |
| | 74 | ||第三批|| 搜索页2页面 || 2.11[#point211 搜索产品(品牌分类统计) ] ||- || - || 8/7 || 0% || 接口实际完成时间 || 接口确认 |
| | 75 | ||第四批|| 发送评论[[BR]](戴裕文补充) ||2.10[#point210 产品发送评论 ] || - || 3.4 [#point304 产品发送评论][[BR]]郑华聪 袁火青 || 8/8 || 0% || 接口实际完成时间 || 接口确认 |
| | 76 | ||第四批|| 产品搜索热点推荐[[BR]](戴裕文补充) ||2.13[#point213 产品搜索热点推荐 ] || - || 3.6 [#point306 产品搜索热点推荐(编辑出)][[BR]] 郑华聪 袁火青 || 8/8|| 0% || 接口实际完成时间 || 接口确认 |
| | 77 | |
| | 78 | |
| | 79 | |
| | 80 | |
| | 81 | == 2. [=#point200 mrobot的接口 ] == |
| | 82 | mrobot自身的接口,由客户端调用 |
| | 83 | |
| | 84 | === 2.1 [=#point201 产品终端页报价 ] === |
| | 85 | {{{ |
| | 86 | HTTP请求方式:get |
| | 87 | 是否需要登录:否 |
| | 88 | 请求参数:productID: 类型id |
| | 89 | areaName:地区名,该参数需要url编码 |
| | 90 | http://mrobot.pconline.com.cn/v2/product/price/priductid |
| | 91 | |
| | 92 | 返回参数{ |
| | 93 | 报价html: |
| | 94 | 添加“网上比价”按钮,链接:pcaction://comparePrice/{$productId} |
| | 95 | } |
| | 96 | |
| | 97 | }}} |
| | 98 | |
| | 99 | === 2.2 [=#point202 产品终端页网上比价 ] === |
| | 100 | {{{ |
| | 101 | |
| | 102 | HTTP请求方式:get |
| | 103 | 是否需要登录:否 |
| | 104 | 请求参数:productID: 类型id |
| | 105 | http://mrobot.pconline.com.cn/v2/product/comparePrice/priductid |
| | 106 | 返回参数{ |
| | 107 | 网上比价html |
| | 108 | 每个商城添加一个“购买”按钮,链接到对应商城的产品终端页 |
| | 109 | } |
| | 110 | |
| | 111 | |
| | 112 | |
| | 113 | 类似于 |
| | 114 | 产品终端-查看所有经销商报价: http://mrobot.pconline.com.cn/v2/product/dealers/{产品id} |
| | 115 | 例子: http://mrobot.pconline.com.cn/v2/product/dealers/485270 |
| | 116 | }}} |
| | 117 | |
| | 118 | === 2.3 [=#point203 产品终端页概述 ] === |
| | 119 | {{{ |
| | 120 | HTTP请求方式:get |
| | 121 | 是否需要登录:否 |
| | 122 | 请求参数:productID: 类型id |
| | 123 | http://mrobot.pconline.com.cn/v2/product/abstact/priductid |
| | 124 | 返回参数{· |
| | 125 | 产品概述的html; |
| | 126 | 添加“进入论坛”按钮:pcaction://bbs-topics/{$bbsid} |
| | 127 | |
| | 128 | } |
| | 129 | }}} |
| | 130 | |
| | 131 | === 2.4 [=#point204 产品终端页报参数] === |
| | 132 | {{{ |
| | 133 | 是否需要登录:否 |
| | 134 | 请求参数:productID: 类型id |
| | 135 | http://mrobot.pconline.com.cn/v2/product/detail/priductid |
| | 136 | 返回参数{· |
| | 137 | 产品具体参数的html; |
| | 138 | } |
| | 139 | }}} |
| | 140 | |
| | 141 | === 2.5 [=#point205 产品对比页 ] === |
| | 142 | {{{ |
| | 143 | |
| | 144 | 请求方式:get |
| | 145 | 是否需要登录:否 |
| | 146 | 请求参数: |
| | 147 | Id1和id2:是需要对比的两个产品 |
| | 148 | hideSameParams:真为true,假为false;真则隐藏相同的参数,否则显示所有参数。 |
| | 149 | }}} |
| | 150 | |
| | 151 | === 2.6 [=#point206 请求产品资讯 ] === |
| | 152 | {{{ |
| | 153 | getArticleListBySerialId |
| | 154 | http://mrobot.pconline.com.cn/v2/product/information/priductid&ordreId=1&fmt=json |
| | 155 | |
| | 156 | 请求方式:get |
| | 157 | 是否需要登录:否 |
| | 158 | 请求参数: |
| | 159 | |
| | 160 | productId:产品id |
| | 161 | orderId:排序方式,1为按热度倒序,2为按热度正序,3为按价格倒序,4为按价格正序,5为按日期倒序,6为按日期正序 |
| | 162 | |
| | 163 | 返回参数{ |
| | 164 | "productId":1021, |
| | 165 | "total":20, |
| | 166 | "orderId":1, |
| | 167 | "fmt":json, |
| | 168 | "articleList":[ |
| | 169 | { |
| | 170 | "id ":1234, |
| | 171 | "title":"苦逼0", |
| | 172 | "channel":"评测", |
| | 173 | |
| | 174 | }, |
| | 175 | { |
| | 176 | "id ":1234, |
| | 177 | "title":"苦逼0", |
| | 178 | "channel":"评测", |
| | 179 | |
| | 180 | } |
| | 181 | ] |
| | 182 | } |
| | 183 | |
| | 184 | id 文章id |
| | 185 | title 标题 |
| | 186 | channel 文章栏目 |
| | 187 | commentNum 评论数 |
| | 188 | }}} |
| | 189 | |
| | 190 | === 2.7 [=#point207 某产品类型的品牌列表 ] === |
| | 191 | {{{ |
| | 192 | HTTP请求方式:get |
| | 193 | 是否需要登录:否 |
| | 194 | 请求参数: |
| | 195 | typeID: 产品类型id |
| | 196 | http://mrobot.pconline.com.cn/v2/product/brand/41234 |
| | 197 | |
| | 198 | 返回参数: |
| | 199 | { |
| | 200 | "type":2, |
| | 201 | |
| | 202 | "partition":{ |
| | 203 | "recommondBrands":{ |
| | 204 | "total":3, |
| | 205 | “brands”:[ |
| | 206 | { |
| | 207 | "id": 693, |
| | 208 | "logo": "http:\/\/img0.pcauto.com.cn\/pcauto |
| | 209 | |
| | 210 | \/1112\/07\/1743776_ACS5050.png", |
| | 211 | "letter": "A", |
| | 212 | "name": "af" |
| | 213 | }, |
| | 214 | ...... |
| | 215 | ] |
| | 216 | }, |
| | 217 | "totalBrands":{ |
| | 218 | "total":20, |
| | 219 | "sections": [ |
| | 220 | { |
| | 221 | "brands": [ |
| | 222 | { |
| | 223 | "id": 693, |
| | 224 | "logo": "http:\/\/img0.pcauto.com.cn\/pcauto |
| | 225 | |
| | 226 | \/1112\/07\/1743776_ACS5050.png", |
| | 227 | "letter": "A", |
| | 228 | "name": "AC瀹濋┈" |
| | 229 | }, |
| | 230 | ...... |
| | 231 | ], |
| | 232 | "index": "A", |
| | 233 | "rowNum": 3 |
| | 234 | }, |
| | 235 | { |
| | 236 | "brands": [ |
| | 237 | { |
| | 238 | "id": 723, |
| | 239 | "logo": "http:\/\/img0.pcauto.com.cn\/pcauto |
| | 240 | |
| | 241 | \/1203\/27\/1875156_babosi5050png.png", |
| | 242 | "letter": "B", |
| | 243 | "name": "宸村崥鏂?" |
| | 244 | }, |
| | 245 | ...... |
| | 246 | ], |
| | 247 | "index": "B", |
| | 248 | "rowNum": 15 |
| | 249 | }, |
| | 250 | { |
| | 251 | "brands": [ |
| | 252 | { |
| | 253 | "id": 723, |
| | 254 | "logo": "http:\/\/img0.pcauto.com.cn\/pcauto |
| | 255 | |
| | 256 | \/1203\/27\/1875156_babosi5050png.png", |
| | 257 | "letter": "Z", |
| | 258 | "name": "宸村崥鏂?" |
| | 259 | }, |
| | 260 | ...... |
| | 261 | |
| | 262 | ], |
| | 263 | "index": "Z", |
| | 264 | "rowNum": 2 |
| | 265 | } |
| | 266 | } |
| | 267 | } |
| | 268 | } |
| | 269 | |
| | 270 | type :请求的类型 |
| | 271 | partition-order-by:A,B,C等块内部,品牌的次序;目前没有参数,默认为空 |
| | 272 | partition:分块集 |
| | 273 | recommondBrands:推荐版块集合, |
| | 274 | totalBrands;品牌的总集合 |
| | 275 | total:版块集合内部元素的总数 |
| | 276 | brands:版块内品牌集合 |
| | 277 | id:品牌id |
| | 278 | logo:品牌logo图片url |
| | 279 | letter;品牌名称首字母 |
| | 280 | name:品牌名称 |
| | 281 | sections:品牌的总集合的分块,按字母顺序分 |
| | 282 | index:分块所属的字母 |
| | 283 | rowNum:分块内品牌数量 |
| | 284 | }}} |
| | 285 | |
| | 286 | === 2.8 [=#point208 产品列表 ] === |
| | 287 | {{{ |
| | 288 | 类似于老版本分类产品列表: http://mrobot.pconline.com.cn/v2/product/types/{产品分类id}?pageNo=1&orderId=1&fmt=json |
| | 289 | 例子: http://mrobot.pconline.com.cn/v2/product/types/20937?pageNo=1&orderId=1&fmt=json |
| | 290 | |
| | 291 | 请求方式:get |
| | 292 | 是否需要登录:否 |
| | 293 | 请求参数: |
| | 294 | |
| | 295 | typeID:产品分类id |
| | 296 | pageNo:页码 |
| | 297 | orderId:排序方式,1为按热度倒序,2为按热度正序,3为按价格倒序,4为按价格正序,5为按日期倒序,6为按日期正序 |
| | 298 | fmt:返回格式 |
| | 299 | 需要添加请求参数 brandID:品牌id |
| | 300 | |
| | 301 | |
| | 302 | }}} |
| | 303 | |
| | 304 | === 2.9 [=#point209 产品点评界面 ] === |
| | 305 | {{{ |
| | 306 | HTTP请求方式:get |
| | 307 | 是否需要登录:否 |
| | 308 | 请求参数:productID: 类型id |
| | 309 | http://mrobot.pconline.com.cn/v2/product/comment/productId |
| | 310 | { |
| | 311 | 添加“我要点评”按钮:pcaction://postComment/{$productId} |
| | 312 | } |
| | 313 | }}} |
| | 314 | |
| | 315 | === 2.10 [=#point210 产品发送评论 ] === |
| | 316 | {{{ |
| | 317 | 发送参数类似于文章,论坛发送评论。 |
| | 318 | HTTP请求方式:post |
| | 319 | 是否需要登录:都可以 |
| | 320 | 请求参数: |
| | 321 | productid:产品id |
| | 322 | producturl;产品url |
| | 323 | score:评分数值 |
| | 324 | content:评论内容 |
| | 325 | isanonymous 是否匿名 |
| | 326 | common_session_Id:用户的author_token |
| | 327 | |
| | 328 | }}} |
| | 329 | |
| | 330 | === 2.11 [=#point211 搜索产品(品牌分类统计) ] === |
| | 331 | {{{ |
| | 332 | HTTP请求方式:get |
| | 333 | 是否需要登录:否 |
| | 334 | 请求参数:kw:查询关键字 |
| | 335 | |
| | 336 | Uri :http://mrobot.pcauto.com.cn/v2/price/models/search-type?kw=%E5%AE%9D%E9%A9%AC |
| | 337 | 返回参数: |
| | 338 | { |
| | 339 | "kw":"sony", |
| | 340 | "totle":1000, |
| | 341 | "types":[ |
| | 342 | { |
| | 343 | "sid":42123, |
| | 344 | "name":"手机", |
| | 345 | "num":100 |
| | 346 | },{ |
| | 347 | "sid":42123, |
| | 348 | "name":"笔记本", |
| | 349 | "num":10 |
| | 350 | 0 |
| | 351 | },{ |
| | 352 | "sid":42123, |
| | 353 | "name":"平板电脑", |
| | 354 | "num":100 |
| | 355 | },{ |
| | 356 | "sid":42123, |
| | 357 | "name":"数码相机", |
| | 358 | "num":100, |
| | 359 | |
| | 360 | },{ |
| | 361 | "sid":42123, |
| | 362 | "name":"超级本", |
| | 363 | "num":10 |
| | 364 | } |
| | 365 | ] |
| | 366 | } |
| | 367 | |
| | 368 | kw:搜索关键字(采用UTF-8方式编码), |
| | 369 | totle:结果集的总数, |
| | 370 | types:类型的集合, |
| | 371 | |
| | 372 | (可以为 产品类型id) |
| | 373 | |
| | 374 | }}} |
| | 375 | |
| | 376 | === 2.12 [=#point212 搜索产品(产品结果列表)] === |
| | 377 | {{{ |
| | 378 | HTTP请求方式:get |
| | 379 | 是否需要登录:否 |
| | 380 | 请求参数:kw:查询关键字 |
| | 381 | type:查询的类型id |
| | 382 | pageNo:显示的页码,默认为1; |
| | 383 | orderId:排序方式,1为按热度倒序,2为按热度正序,3为按价格倒序,4为按价格正序,5为按日期倒序,6为按日期正序 |
| | 384 | http://ks.pconline.com.cn/search.jsp?appName=product&returnType=json&return=smalltype_id,category,shortName,hot_new,id,title,pub_url,pic,summary,price&sort=score:desc,access:desc&perPage=25&pageNo=1&highlight=false&q=55&clusterQuery=cluster_smalltype%3A%B1%CA%BC%C7%B1%BE |
| | 385 | |
| | 386 | |
| | 387 | Uri:http://mrobot.pconline.com.cn/v2/product/models/search?kw=fa&type=4234&pageNo=1&order=1 |
| | 388 | 返回参数: |
| | 389 | { |
| | 390 | "kw":"sony", |
| | 391 | "type":4 |
| | 392 | "pageNo": "1", |
| | 393 | "orderId":1, |
| | 394 | "total": 113, |
| | 395 | "pageCount": 5, |
| | 396 | "pageSize": 25, |
| | 397 | "data": [ |
| | 398 | { |
| | 399 | "is-ultrabook": 0, |
| | 400 | "id": "503012", |
| | 401 | "hotNew": "2", |
| | 402 | "price": "4599", |
| | 403 | "items": [ |
| | 404 | "相机类型", |
| | 405 | "卡片数码相机", |
| | 406 | "有效像素", |
| | 407 | "1210万像素", |
| | 408 | "变焦倍数", |
| | 409 | "无光学变焦", |
| | 410 | "传感器尺寸", |
| | 411 | "1\/2.3英寸", |
| | 412 | "等效焦距", |
| | 413 | "21mm", |
| | 414 | "液晶屏尺寸", |
| | 415 | "3英寸", |
| | 416 | "高清视频", |
| | 417 | "1080p 1920×1080逐行", |
| | 418 | "存储介质", |
| | 419 | "SD卡,SDHC卡", |
| | 420 | "重量", |
| | 421 | "157g(包含存储卡),155g(不包含存储卡)" |
| | 422 | ], |
| | 423 | "idxPic": "http:\/\/img.pconline.com.cn\/images\/product\/5030\/503012\/dc_casio_tr150_1_sn.jpg", |
| | 424 | "shortName": "卡西欧 EXILIM EX-TR150", |
| | 425 | "url": "http:\/\/mrobot.pconline.com.cn\/v2\/product\/models\/503012" |
| | 426 | } |
| | 427 | .. |
| | 428 | ,{ |
| | 429 | "is-ultrabook": 0, |
| | 430 | "id": "471231", |
| | 431 | "hotNew": "0", |
| | 432 | "price": "288", |
| | 433 | "items": [ |
| | 434 | "适用类型", |
| | 435 | "台式机", |
| | 436 | "电源标准", |
| | 437 | "ATX,2.31", |
| | 438 | "额定功率", |
| | 439 | "350W", |
| | 440 | "CPU供电接口", |
| | 441 | "4+4pin", |
| | 442 | "大4Pin接口", |
| | 443 | "4个", |
| | 444 | "SATA接口", |
| | 445 | "3个", |
| | 446 | "PFC类型", |
| | 447 | "被动式PFC", |
| | 448 | "风扇描述", |
| | 449 | "一个12CM风扇,散热片" |
| | 450 | ], |
| | 451 | "idxPic": "http:\/\/img.pconline.com.cn\/images\/product\/4712\/471231\/pow_tt_450-1_sn.jpg", |
| | 452 | "shortName": "TT TR2-450", |
| | 453 | "url": "http:\/\/mrobot.pconline.com.cn\/v2\/product\/models\/471231" |
| | 454 | } |
| | 455 | ] |
| | 456 | |
| | 457 | } |
| | 458 | |
| | 459 | 类似于搜索超极本:http://mrobot.pconline.com.cn/v2/product/models/search_ultrabook?keyword=%E8%81%94%E6%83%B3&pageNo=1&order=1 |
| | 460 | 请求方式:get是否需要登录:否请求参数: |
| | 461 | keyword:搜索关键字,需要url编码pageNo:请求页码order:同产品分类列表 |
| | 462 | }}} |
| | 463 | |
| | 464 | === 2.13 [=#point213 产品搜索热点推荐 ] === |
| | 465 | {{{ |
| | 466 | HTTP请求方式:get |
| | 467 | 是否需要登录:否 |
| | 468 | 请求参数: |
| | 469 | fmt:返回格式 |
| | 470 | Uri:http://mrobot.pconline.com.cn/v2/product/hotspot |
| | 471 | |
| | 472 | 返回参数: |
| | 473 | { |
| | 474 | "total":3, |
| | 475 | "fmt":"json", |
| | 476 | "words":[ |
| | 477 | { |
| | 478 | "name": "三星", |
| | 479 | }, |
| | 480 | ...... |
| | 481 | ] |
| | 482 | |
| | 483 | } |
| | 484 | |
| | 485 | |
| | 486 | |
| | 487 | 说明: |
| | 488 | total:热点推荐总数 |
| | 489 | fmt:返回的格式 |
| | 490 | words:热点集合 |
| | 491 | name:热点名字 |
| | 492 | image:热点名字 |
| | 493 | }}} |
| | 494 | |
| | 495 | === 2.14 [=#point214 产品首页 ] === |
| | 496 | {{{ |
| | 497 | HTTP请求方式:get |
| | 498 | 是否需要登录:否 |
| | 499 | Uri: |
| | 500 | http://mrobot.pconline.com.cn/v2/product/information |
| | 501 | 分类下方外显该分类排名前三的品牌的名称(例如http://product.pconline.com.cn/mobile/ 页面中,品牌分类的前三个品牌“三星 HTC 诺基亚”); |
| | 502 | }}} |
| | 503 | |
| | 504 | |
| | 505 | === 3 [=#point300 配合的接口(产品库接口及编辑出的接口) ] === |
| | 506 | 此部分的接口由产品和编辑的同事配合 |
| | 507 | |
| | 508 | === 3.1 [=#point301 产品终端页网上比价 ] === |
| | 509 | {{{ |
| | 510 | |
| | 511 | HTTP请求方式:get |
| | 512 | 请求参数: |
| | 513 | productID: 产品id |
| | 514 | 返回参数: |
| | 515 | [{ |
| | 516 | storeName:"卓越", |
| | 517 | price:"2499.0", |
| | 518 | shippingRate:"购物满29元免运费", |
| | 519 | buyLink:"http://XXXX" |
| | 520 | },{ |
| | 521 | storeName:"卓越", |
| | 522 | price:"2499.0", |
| | 523 | shippingRate:"购物满29元免运费", |
| | 524 | buyLink:"http://XXXX" |
| | 525 | }] |
| | 526 | 备注: |
| | 527 | 商城名称:storeName |
| | 528 | 报价:price |
| | 529 | 运费:shippingRate |
| | 530 | 购买:buyLink |
| | 531 | 网页版类似页面:http://product.pconline.com.cn/pdlib/pk/price410030.html |
| | 532 | 效果图: |
| | 533 | |
| | 534 | }}} |
| | 535 | |
| | 536 | |
| | 537 | === 3.2 [=#point302 产品资讯接口 ] === |
| | 538 | {{{ |
| | 539 | |
| | 540 | HTTP请求方式:get |
| | 541 | 请求参数: |
| | 542 | productId:产品id |
| | 543 | pageNo:第几页 |
| | 544 | pageSize:分页数 |
| | 545 | |
| | 546 | 返回参数 |
| | 547 | { |
| | 548 | "productId":1021, |
| | 549 | "total":20, |
| | 550 | "articleList":[ |
| | 551 | { |
| | 552 | "id ":1234, |
| | 553 | "title":"苦逼0", |
| | 554 | "channel":"评测", |
| | 555 | "image":"http://xxdxx.jpg" |
| | 556 | }, |
| | 557 | { |
| | 558 | "id ":1234, |
| | 559 | "title":"苦逼0", |
| | 560 | "channel":"导购", |
| | 561 | "image":"http://xxdxx.jpg" |
| | 562 | } |
| | 563 | ] |
| | 564 | } |
| | 565 | |
| | 566 | 备注: |
| | 567 | id 文章id |
| | 568 | title 标题 |
| | 569 | channel 文章栏目,"评测"还是“行情” |
| | 570 | image 导读图 |
| | 571 | 网页版类似页面:product.pconline.com.cn/mobile/nokia/410030_review.html |
| | 572 | 效果图: |
| | 573 | |
| | 574 | |
| | 575 | }}} |
| | 576 | |
| | 577 | === 3.3 [=#point303 某产品类型的品牌列表 ] === |
| | 578 | {{{ |
| | 579 | |
| | 580 | HTTP请求方式:get |
| | 581 | 请求参数: |
| | 582 | typeID: 产品类型id,例如手机20937 |
| | 583 | |
| | 584 | 返回参数: |
| | 585 | { |
| | 586 | "typeId": 20937, |
| | 587 | "totalBrands": { |
| | 588 | "total": 20, |
| | 589 | "sections": [ |
| | 590 | { |
| | 591 | "brands": [ |
| | 592 | { |
| | 593 | "id": 693, |
| | 594 | "logo": "http://img0.pcauto.com.cn/pcauto/1112/07/1743776_ACS5050.png", |
| | 595 | "letter": "A", |
| | 596 | "name": "APPLE" |
| | 597 | }, |
| | 598 | { |
| | 599 | "id": 693, |
| | 600 | "logo": "http://img0.pcauto.com.cn/pcauto/1112/07/1743776_ACS5050.png", |
| | 601 | "letter": "A", |
| | 602 | "name": "A" |
| | 603 | } |
| | 604 | ], |
| | 605 | "index": "A", |
| | 606 | "rowNum": 3 |
| | 607 | }, |
| | 608 | { |
| | 609 | "brands": [ |
| | 610 | { |
| | 611 | "id": 723, |
| | 612 | "logo": "http://img0.pcauto.com.cn/pcauto/1203/27/1875156_babosi5050png.png", |
| | 613 | "letter": "B", |
| | 614 | "name": "B品牌1" |
| | 615 | }, |
| | 616 | { |
| | 617 | "id": 723, |
| | 618 | "logo": "http://img0.pcauto.com.cn/pcauto/1203/27/1875156_babosi5050png.png", |
| | 619 | "letter": "B", |
| | 620 | "name": "B品牌2" |
| | 621 | } |
| | 622 | ], |
| | 623 | "index": "B", |
| | 624 | "rowNum": 15 |
| | 625 | } |
| | 626 | ] |
| | 627 | } |
| | 628 | } |
| | 629 | |
| | 630 | |
| | 631 | typeId :产品类型id,例如手机20937 |
| | 632 | total:版块集合内部元素的总数 |
| | 633 | brands:版块内品牌集合 |
| | 634 | id:品牌id |
| | 635 | logo:品牌logo图片url |
| | 636 | letter;品牌名称首字母 |
| | 637 | name:品牌名称 |
| | 638 | sections:品牌的总集合的分块,按字母A-Z顺序分 |
| | 639 | index:分块所属的字母 |
| | 640 | rowNum:分块内品牌数量 |
| | 641 | |
| | 642 | 备注: |
| | 643 | 网页版类似页面http://product.pconline.com.cn/notebook/ |
| | 644 | |
| | 645 | }}} |
| | 646 | |
| | 647 | === 3.4 [=#point304 产品发送评论 ] === |
| | 648 | {{{ |
| | 649 | HTTP请求方式:post |
| | 650 | 请求参数: |
| | 651 | productId: 产品ID |
| | 652 | score : 分数 从1到5的整数 |
| | 653 | title : 标题 |
| | 654 | advantage :优点 |
| | 655 | deficiency :缺点 |
| | 656 | summary :总结 |
| | 657 | common_session_Id :太平洋网络通行证的sessionId 若为空则匿名发评论 |
| | 658 | |
| | 659 | 返回参数: |
| | 660 | { |
| | 661 | stats:"ok", |
| | 662 | msg:"发送成功" |
| | 663 | } |
| | 664 | |
| | 665 | Stats发送状态,成功为ok,失败为error, |
| | 666 | msg中显示提示的信息 ,例如必填字段未填,或者其他必要的提示等 |
| | 667 | |
| | 668 | 备注: |
| | 669 | 网页版类似页面http://product.pconline.com.cn/mobile/samsung/485270_comment.html#dianping |
| | 670 | |
| | 671 | }}} |
| | 672 | |
| | 673 | === 3.5 [=#point305 显示分类排名前三的品牌 ] === |
| | 674 | {{{ |
| | 675 | HTTP请求方式:get |
| | 676 | 请求参数: |
| | 677 | typeId :产品类型ID,逗号分割,例如手机20937,台式机20806 |
| | 678 | |
| | 679 | 返回参数: |
| | 680 | { |
| | 681 | "20937":["三星","APPLE","HTC"], |
| | 682 | "256567":["三星","APPLE","HTC"], |
| | 683 | "256568":["三星","APPLE","HTC"] |
| | 684 | } |
| | 685 | 备注:返回的顺序按照排名顺序来排 |
| | 686 | 排名顺序根据类似此报价页面的http://product.pconline.com.cn/notebook |
| | 687 | }}} |
| | 688 | |
| | 689 | === 3.6 [=#point306 产品搜索热点推荐(编辑出) ] === |
| | 690 | {{{ |
| | 691 | HTTP请求方式:get |
| | 692 | 是否需要登录:否 |
| | 693 | 请求参数:无 |
| | 694 | |
| | 695 | 返回参数: |
| | 696 | { |
| | 697 | "words":[ |
| | 698 | "三星","htc","苹果","华为" |
| | 699 | ] |
| | 700 | } |
| | 701 | |
| | 702 | 备注:返回最多5个关键词 |
| | 703 | 由编辑设置 |
| | 704 | |
| | 705 | }}} |
| | 706 | |
| | 707 | |
| | 708 | === 3.7 [=#point307 推荐品牌(编辑出) ] === |
| | 709 | {{{ |
| | 710 | HTTP请求方式:get |
| | 711 | 是否需要登录:否 |
| | 712 | 请求参数:无 |
| | 713 | |
| | 714 | 返回参数: |
| | 715 | { |
| | 716 | "total": 2, |
| | 717 | "25289": [{ |
| | 718 | "id": 693, |
| | 719 | "name":"联想", |
| | 720 | "logo": "http:\/\/img0.pcauto.com.cn\/pcauto\/1112\/07\/1743776_ACS5050.png", |
| | 721 | }, |
| | 722 | { |
| | 723 | "id": 693, |
| | 724 | "name":"联想", |
| | 725 | "logo": "http:\/\/img0.pcauto.com.cn\/pcauto\/1112\/07\/1743776_ACS5050.png", |
| | 726 | }], |
| | 727 | "25293": [{ |
| | 728 | "id": 693, |
| | 729 | "name":"联想", |
| | 730 | "logo": "http:\/\/img0.pcauto.com.cn\/pcauto\/1112\/07\/1743776_ACS5050.png", |
| | 731 | }, |
| | 732 | { |
| | 733 | "id": 693, |
| | 734 | "name":"联想", |
| | 735 | "logo": "http:\/\/img0.pcauto.com.cn\/pcauto\/1112\/07\/1743776_ACS5050.png", |
| | 736 | }] |
| | 737 | |
| | 738 | } |
| | 739 | 备注:返回编辑推荐的品牌 |
| | 740 | 此关键词为编辑设置 |
| | 741 | |
| | 742 | total:版块集合内部元素的总数 |
| | 743 | 25289,25293类似的数字,产品类型 |
| | 744 | id:品牌id |
| | 745 | logo:品牌logo图片url |
| | 746 | name:品牌名称 |
| | 747 | |
| | 748 | }}} |
| | 749 | |
| | 750 | |
| | 751 | == 5. [=#point500 修改历史 ] == |
| | 752 | |
| | 753 | 2012-08-02: |
| | 754 | -接口第一版 |