Yoho-Documents / API-Interfaces · Commits

Go to a project

Authored by caoyan
Commit 85e8762a53f326d397436f3582b1e99cfeb33f8a 1 parent c8769715

Update brandSearch.md

Inline Side-by-side
Showing 1 changed file with 144 additions and 102 deletions
1 -##热搜品牌列表接口##  
2 -  
3 -（method=app.search.hotBrands）  
4 -#### 请求参数  
5 -| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |  
6 -|:-------| -----:|-----:|-----:|-----:|----:|  
7 -  
8 -  
9 -注意，通用的头部没有列出。  
10 -请求示例  
11 -http://devapi.yoho.cn:58078/?debug=XYZ&app_version=3.8.2&client_type=android&os_version=yohobuy%3Ah5&screen_size=720x1280&v=7&method=app.search.hotBrands  
12 -  
13 -### 响应  
14 -code为200即为成功，否则是失败。  
15 -响应JSON格式如下所示:  
16 -```json  
17 -{  
18 - "code": 200,  
19 - "data": [  
20 - {  
21 - "brandId": 1616, --品牌id  
22 - "brandName": "12", --品牌名  
23 - "brandDomain" : "",-- 品牌domain  
24 - "orderBy": 12123 --排序  
25 - },  
26 - {  
27 - "brandId": 1616,  
28 - "brandName": "12",  
29 - "orderBy": 1123  
30 - },  
31 - {  
32 - "brandId": 1632,  
33 - "brandName": "test1",  
34 - "orderBy": 122  
35 - },  
36 -  
37 - ],  
38 -  
39 - "md5": "d4d43382e074027624d686bc8b909a93",  
40 - "message": "查询品牌热搜词成功"  
41 -}  
42 -  
43 -```  
44 -  
45 -## 2、查询搜索品牌历史记录接口##  
46 -  
47 -（method=app.search.hotBrandRecords）  
48 -#### 请求参数  
49 -| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |  
50 -|:-------| -----:|-----:|-----:|-----:|----:|  
51 -|uid|int|是|248|0|用户id|  
52 -|records|String[]| 否|["时间戳_品牌_brandDomain_brandId"]|-|状态|  
53 -  
54 -注意，通用的头部没有列出。  
55 -请求示例  
56 -http://devapi.yoho.cn:58078/?debug=XYZ&app_version=3.8.2&client_type=android&os_version=yohobuy%3Ah5&screen_size=720x1280&v=7&method=app.search.hotBrandRecords&debug=XYZ&uid=9999&records  
57 -### 响应  
58 -code为200即为成功，否则是失败。  
59 -响应JSON格式如下所示:  
60 -```json  
61 -{  
62 - "alg": "SALT_MD5",  
63 - "code": 200,  
64 - "data": [  
65 - {  
66 - "searchTerms": "test-chen", --品牌  
67 - "searchTime": 1452043863, --时间戳  
68 - "brandId": 1616, --品牌id  
69 - "brandDomain" : "",-- 品牌domain  
70 - },  
71 - {  
72 - "searchTerms": "test-cc",  
73 - "searchTime": 1452043873  
74 - }  
75 -],  
76 - "md5": "e24c0c724646c486236bf24b7cb2a9a5",  
77 - "message": "success"  
78 -}  
79 -```  
80 -  
81 -## 3、清理品牌历史##  
82 -  
83 -（method=app.search.clearHotBrandRecords）  
84 -#### 请求参数  
85 -| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |  
86 -|:-------| -----:|-----:|-----:|-----:|----:|  
87 -|uid|int|是|248|0|用户id|  
88 -  
89 -注意，通用的头部没有列出。  
90 -请求示例  
91 -http://devapi.yoho.cn:58078/?debug=XYZ&app_version=3.8.2&client_type=android&os_version=yohobuy%3Ah5&screen_size=720x1280&v=7&method=app.search.clearHotBrandRecords&debug=XYZ&uid=9999  
92 -### 响应  
93 -code为200即为成功，否则是失败。  
94 -响应JSON格式如下所示:  
95 -```json  
96 -{  
97 - "alg": "SALT_MD5",  
98 - "code": 200,  
99 -  
100 - "md5": "89445294eb4487a1233cff63b1df01e7",  
101 - "message": "brand info"  
102 -} 1 +##热搜品牌列表接口##
  2 +
  3 +（method=app.search.hotBrands）
  4 +#### 请求参数
  5 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
  6 +|:-------| -----:|-----:|-----:|-----:|----:|
  7 +
  8 +
  9 +注意，通用的头部没有列出。
  10 +请求示例
  11 +http://devapi.yoho.cn:58078/?debug=XYZ&app_version=3.8.2&client_type=android&os_version=yohobuy%3Ah5&screen_size=720x1280&v=7&method=app.search.hotBrands
  12 +
  13 +### 响应
  14 +code为200即为成功，否则是失败。
  15 +响应JSON格式如下所示:
  16 +```json
  17 +{
  18 + "code": 200,
  19 + "data": [
  20 + {
  21 + "brandId": 1616, --品牌id
  22 + "brandName": "12", --品牌名
  23 + "brandDomain" : "",-- 品牌domain
  24 + "orderBy": 12123 --排序
  25 + },
  26 + {
  27 + "brandId": 1616,
  28 + "brandName": "12",
  29 + "orderBy": 1123
  30 + },
  31 + {
  32 + "brandId": 1632,
  33 + "brandName": "test1",
  34 + "orderBy": 122
  35 + },
  36 +
  37 + ],
  38 +
  39 + "md5": "d4d43382e074027624d686bc8b909a93",
  40 + "message": "查询品牌热搜词成功"
  41 +}
  42 +
  43 +```
  44 +
  45 +## 2、查询搜索品牌历史记录接口##
  46 +
  47 +（method=app.search.hotBrandRecords）
  48 +#### 请求参数
  49 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
  50 +|:-------| -----:|-----:|-----:|-----:|----:|
  51 +|uid|int|是|248|0|用户id|
  52 +|records|String[]| 否|["时间戳_品牌_brandDomain_brandId"]|-|状态|
  53 +
  54 +注意，通用的头部没有列出。
  55 +请求示例
  56 +http://devapi.yoho.cn:58078/?debug=XYZ&app_version=3.8.2&client_type=android&os_version=yohobuy%3Ah5&screen_size=720x1280&v=7&method=app.search.hotBrandRecords&debug=XYZ&uid=9999&records
  57 +### 响应
  58 +code为200即为成功，否则是失败。
  59 +响应JSON格式如下所示:
  60 +```json
  61 +{
  62 + "alg": "SALT_MD5",
  63 + "code": 200,
  64 + "data": [
  65 + {
  66 + "searchTerms": "test-chen", --品牌
  67 + "searchTime": 1452043863, --时间戳
  68 + "brandId": 1616, --品牌id
  69 + "brandDomain" : "",-- 品牌domain
  70 + },
  71 + {
  72 + "searchTerms": "test-cc",
  73 + "searchTime": 1452043873
  74 + }
  75 +],
  76 + "md5": "e24c0c724646c486236bf24b7cb2a9a5",
  77 + "message": "success"
  78 +}
  79 +```
  80 +
  81 +## 3、清理品牌历史##
  82 +
  83 +（method=app.search.clearHotBrandRecords）
  84 +#### 请求参数
  85 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
  86 +|:-------| -----:|-----:|-----:|-----:|----:|
  87 +|uid|int|是|248|0|用户id|
  88 +
  89 +注意，通用的头部没有列出。
  90 +请求示例
  91 +http://devapi.yoho.cn:58078/?debug=XYZ&app_version=3.8.2&client_type=android&os_version=yohobuy%3Ah5&screen_size=720x1280&v=7&method=app.search.clearHotBrandRecords&debug=XYZ&uid=9999
  92 +### 响应
  93 +code为200即为成功，否则是失败。
  94 +响应JSON格式如下所示:
  95 +```json
  96 +{
  97 + "alg": "SALT_MD5",
  98 + "code": 200,
  99 +
  100 + "md5": "89445294eb4487a1233cff63b1df01e7",
  101 + "message": "brand info"
  102 +}
  103 +```
  104 +
  105 +## 4、获取品牌信息及其优惠券##
  106 +
  107 +（method=app.brand.getBrandIntro）
  108 +#### 请求参数
  109 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
  110 +|:-------| -----:|-----:|-----:|-----:|----:|
  111 +|brand_id|int|否|600|0|品牌id|
  112 +|uid|int|是|11961101|0|用户id|
  113 +
  114 +注意，通用的头部没有列出。
  115 +请求示例
  116 +http://devapi.yoho.cn:58078/?debug=XYZ&app_version=3.8.2&client_type=android&os_version=yohobuy%3Ah5&screen_size=720x1280&v=7&method=app.brand.getBrandIntro&debug=XYZ&uid=9999&brand_id=536
  117 +### 响应
  118 +code为200即为成功，否则是失败。
  119 +响应JSON格式如下所示:
  120 +```json
  121 +{
  122 + "alg": "SALT_MD5",
  123 + "code": 200,
  124 + "data": {
  125 + "brand_domain": "ablejeans",
  126 + "brand_ico": "http://img13.static.yhbimg.com/brandLogo/2014/05/08/12/0241b56aa9407b25d60b8d6c03ad6396c6.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  127 + "brand_id": "536",
  128 + "brand_intro": " OLD YOHO\nABLE JEANS——An urban jeans brand ,a leader in the trends.\n\nABLE JEANS is an international denim brand. By the epoch-making spirit and aesthetic vision of MODERN CHINESE, ABLE JEANS is creating a modern, young, cool look with its qualified products.\n\nThe creativity and design of ABLE JEANS come from real life, its vintage styles are interpreted in a modern way. The jeans and collections look cool, young, and comfortable to wear. The application of new technology and materials has given the brand a spirit both modern and timeless, fashionable and classic.\n\nABLE JEANS----live cool,Cool is an attitude,is free in you mind,is a natural feeling,is self-confidence,is timeless young,live cool,you are yourself!\n\nABLE JEANS——都市牛仔品牌，潮流版型专家。\nABLE JEANS基于现代中国人（MODERN CHINESE）的划时代精神，审美观，打造摩登、复古的国际化牛仔品牌形象。\n\nABLE JEANS的创意和设计立足于真实的生活态度，用现代感重新演绎复古风潮，穿着舒适修身，自然酷感。新工艺、新材料的运用赋予牛仔品牌现代而永恒，时尚而经典的精神。 \n",
  129 + "brand_name": "ABLE JEANS",
  130 + "coupons": [
  131 + {
  132 + "couponValidity": "2016.07.14-2016.07.26",
  133 + "coupon_id": 12022,
  134 + "coupon_name": "新客ABLE JEANS品牌优惠券满699减100元",
  135 + "coupon_pic": "http://static.yohobuy.com/images/v2/activity/default_coupon.jpg",
  136 + "money": "100.0",
  137 + "status": 1
  138 + }
  139 + ],
  140 + "is_favorite": "N"
  141 + },
  142 + "md5": "af77e943e2fb34ae0137a76fc21aa785",
  143 + "message": "Brand Intro"
  144 +}
103 ``` 145 ```