ttj1314 / API-Interfaces · Commits

Go to a project

Authored by zhengwen.ge
Commit b0d6b3ac8f306cd8c73249b4d811bcf1f1976180 1 parent 99f5c6ea

UPDATE

Inline Side-by-side
Showing 1 changed file with 172 additions and 49 deletions
1 -## 1、用户选择/修改活动商品的sku信息 ## 1 +## 1、用户选择/修改活动商品的sku信息 ##
2 2
3 -用户选择/修改活动商品的sku信息（?method=app.drawline.userChoiceSku）  
4 -#### 请求参数  
5 -| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | 3 +用户选择/修改活动商品的sku信息（?method=app.drawline.userChoiceSku）
  4 +#### 请求参数
  5 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
6 |:-------| -----:|-----:|-----:|-----:|----:| 6 |:-------| -----:|-----:|-----:|-----:|----:|
7 -|uid|int|否|205455||用户id|  
8 -|productSkn|int|否|12556||skn|  
9 -|productSku|int|否|25665||sku|  
10 -|productSkc|int|否|15566||skc|  
11 -|colorName|String|否|蓝色||颜色|  
12 -|sizeName|String|否|L||尺码|  
13 -  
14 -注意，通用的头部没有列出。  
15 -请求示例  
16 -http://192.168.102.205:8080/activity?method=app.drawline.userChoiceSku&uid=12342&productSkn=56665&productSku=222&colorName=蓝色&sizeName=L&productSkc=15556  
17 -  
18 -### 响应  
19 -code为200即为成功，否则是失败。  
20 -响应参数，data部分  
21 -响应成功JSON格式如下所示: 7 +|uid|int|否|205455||用户id|
  8 +|productSkn|int|否|12556||skn|
  9 +|productSku|int|否|25665||sku|
  10 +|productSkc|int|否|15566||skc|
  11 +|colorName|String|否|蓝色||颜色|
  12 +|sizeName|String|否|L||尺码|
  13 +
  14 +注意，通用的头部没有列出。
  15 +请求示例
  16 +http://192.168.102.205:8080/activity?method=app.drawline.userChoiceSku&uid=12342&productSkn=56665&productSku=222&colorName=蓝色&sizeName=L&productSkc=15556
  17 +
  18 +### 响应
  19 +code为200即为成功，否则是失败。
  20 +响应参数，data部分
  21 +响应成功JSON格式如下所示:
22 ```json 22 ```json
23 { 23 {
24 "code": 200, 24 "code": 200,
25 - "message": "成功", 25 + "message": "成功",
26 "md5": "6d729d4b35f10fc73531210bd7ecff91", 26 "md5": "6d729d4b35f10fc73531210bd7ecff91",
27 "alg": "SALT_MD5", 27 "alg": "SALT_MD5",
28 "data": [] 28 "data": []
29 } 29 }
30 ``` 30 ```
31 -响应失败JSON格式如下所示: 31 +响应失败JSON格式如下所示:
32 ```json 32 ```json
33 { 33 {
34 "code": 500, 34 "code": 500,
35 - "message": "失败", 35 + "message": "失败",
36 "md5": "6d729d4b35f10fc73531210bd7ecff91", 36 "md5": "6d729d4b35f10fc73531210bd7ecff91",
37 "alg": "SALT_MD5", 37 "alg": "SALT_MD5",
38 "data": [] 38 "data": []
39 } 39 }
40 ``` 40 ```
41 41
42 -## 2、根据uid和skn查询选择的sku信息 ## 42 +## 2、根据uid和skn查询选择的sku信息 ##
43 43
44 -根据uid和活动id查询选择的sku信息（?method=app.drawline.getUserChoiceSku）  
45 -#### 请求参数  
46 -| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | 44 +根据uid和活动id查询选择的sku信息（?method=app.drawline.getUserChoiceSku）
  45 +#### 请求参数
  46 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
47 |:-------| -----:|-----:|-----:|-----:|----:| 47 |:-------| -----:|-----:|-----:|-----:|----:|
48 -|uid|int|否|205455||用户id|  
49 -|productSkn|int|否|12556||skn| 48 +|uid|int|否|205455||用户id|
  49 +|productSkn|int|否|12556||skn|
50 50
51 -注意，通用的头部没有列出。  
52 -请求示例 51 +注意，通用的头部没有列出。
  52 +请求示例
53 http://192.168.102.205:8080/activity?method=app.drawline.getUserChoiceSku&uid=12342&productSkn=56665 53 http://192.168.102.205:8080/activity?method=app.drawline.getUserChoiceSku&uid=12342&productSkn=56665
54 54
55 -### 响应  
56 -code为200即为成功，否则是失败。  
57 -响应参数，data部分  
58 -响应成功JSON格式如下所示: 55 +### 响应
  56 +code为200即为成功，否则是失败。
  57 +响应参数，data部分
  58 +响应成功JSON格式如下所示:
59 ```json 59 ```json
60 { 60 {
61 "code": 200, 61 "code": 200,
62 - "message": "操作成功", 62 + "message": "操作成功",
63 "md5": "9db2bfc15fdd507d2f5845c8bc74d337", 63 "md5": "9db2bfc15fdd507d2f5845c8bc74d337",
64 "alg": "SALT_MD5", 64 "alg": "SALT_MD5",
65 "data": { 65 "data": {
@@ -68,37 +68,37 @@ code为200即为成功，否则是失败。 @@ -68,37 +68,37 @@ code为200即为成功，否则是失败。
68 "activityId": 56665, 68 "activityId": 56665,
69 "productSku": 222, 69 "productSku": 222,
70 "productSkc": 333, 70 "productSkc": 333,
71 - "colorName": "蓝色", 71 + "colorName": "蓝色",
72 "sizeName": "L" 72 "sizeName": "L"
73 } 73 }
74 } 74 }
75 ``` 75 ```
76 76
77 -## 3、根据skn获取平台配置的sku的商品详细信息 ##  
78 -根据skn获取平台配置的sku的商品详细信息（?method=app.drawline.getGoodListBySkus）  
79 -#### 请求参数  
80 -| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | 77 +## 3、根据skn获取平台配置的sku的商品详细信息 ##
  78 +根据skn获取平台配置的sku的商品详细信息（?method=app.drawline.getGoodListBySkus）
  79 +#### 请求参数
  80 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
81 |:-------| -----:|-----:|-----:|-----:|----:| 81 |:-------| -----:|-----:|-----:|-----:|----:|
82 -|skn|String|否|205455||用户id| 82 +|skn|String|否|205455||用户id|
83 83
84 -注意，通用的头部没有列出。  
85 -请求示例 84 +注意，通用的头部没有列出。
  85 +请求示例
86 http://192.168.102.205:8080/activity?method=app.drawline.getGoodListBySkus&skn=12342 86 http://192.168.102.205:8080/activity?method=app.drawline.getGoodListBySkus&skn=12342
87 87
88 -### 响应  
89 -code为200即为成功，否则是失败。  
90 -响应参数，data部分  
91 -响应成功JSON格式如下所示: 88 +### 响应
  89 +code为200即为成功，否则是失败。
  90 +响应参数，data部分
  91 +响应成功JSON格式如下所示:
92 ```json 92 ```json
93 { 93 {
94 "code": 200, 94 "code": 200,
95 - "message": "操作成功", 95 + "message": "操作成功",
96 "md5": "9db2bfc15fdd507d2f5845c8bc74d337", 96 "md5": "9db2bfc15fdd507d2f5845c8bc74d337",
97 "alg": "SALT_MD5", 97 "alg": "SALT_MD5",
98 "data": [ 98 "data": [
99 { 99 {
100 "color_id": 7, 100 "color_id": 7,
101 - "color_name": "蓝色", 101 + "color_name": "蓝色",
102 "goods_id": 460439, 102 "goods_id": 460439,
103 "product_skc": 338873, 103 "product_skc": 338873,
104 "size_list": [ 104 "size_list": [
@@ -117,3 +117,126 @@ code为200即为成功，否则是失败。 @@ -117,3 +117,126 @@ code为200即为成功，否则是失败。
117 ] 117 ]
118 } 118 }
119 ``` 119 ```
  120 +
  121 +## 4、参加SKU排队活动时检测APP版本号##
  122 +参加SKU排队活动时检测APP版本号（method=app.drawline.addQueue）
  123 +#### 请求参数
  124 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
  125 +|:-------| -----:|-----:|-----:|-----:|----:|
  126 +|activityId|Integer|否||无|活动id|
  127 +|app_version|String|否||无|版本号|
  128 +|uid|Integer|否||无||
  129 +|userType|Byte|是||||
  130 +|sort|Integer|是|||排队序号|
  131 +|limit|Integer|是|||分页大小|
  132 +
  133 +注意，通用的头部没有列出。
  134 +请求示例http://127.0.0.1:8090/activity/?method=app.drawline.addQueue&limitProductCode=3&app_version=4.0.1&uid=109&activityId=11
  135 +
  136 +### 响应
  137 +code为200即为成功，否则是失败。
  138 +响应JSON格式如下所示:
  139 +```json
  140 +{
  141 + "code": 900001006,
  142 + "message": "版本过低，请更新",
  143 + "md5": "f4a7a490bb6666b005008d795ed14e5d",
  144 + "alg": "SALT_MD5",
  145 + "data": {}
  146 +}
  147 +```
  148 +## 5、我的限购码##
  149 +我的限购码（method=
  150 +）
  151 +#### 请求参数
  152 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
  153 +|:-------| -----:|-----:|-----:|-----:|----:|
  154 +|uid|int|否||无|用户id|
  155 +
  156 +注意，通用的头部没有列出。
  157 +请求示例http://127.0.0.1:8080/gateway/?method=app.limitcode.query&uid=12710899
  158 +
  159 +### 响应
  160 +code为200即为成功，否则是失败。
  161 +```json
  162 +{
  163 + "alg": "SALT_MD5",
  164 + "code": 200,
  165 + "data": {
  166 + "invalidLimitCodeProducts": [],
  167 + "limitCodeProducts": [{
  168 +"defaultUrl":"http://img11.static.yhbimg.com/goodsimg/2016/04/15/11/011c20479a68be0e4ef15cca3b2ce89f6d.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  169 +"limitCode":"2aD3U14L2",
  170 +"limitProductCode":"2016041511502657",
  171 +"price":"¥1499.00",
  172 +"productName":"大牌合作超强联手PUMA x McQ Brace Mid black强势来袭",
  173 +"productSkn":"51162585",
  174 +"productSku":"578965",
  175 +"color_id":"15",
  176 +"size_id":"203",
  177 +"color_name":"黑色"，
  178 +"size_name":"42码",
  179 +"status":"1"
  180 +}]
  181 + },
  182 + "md5": "3023b84ee63d9ea554cbbd0bf40fef62",
  183 + "message": "操作成功"
  184 +}
  185 +```
  186 +
  187 +##6、限定商品详情##
  188 +限定商品详情（method=app.limitProduct.limitProductDetail）
  189 +#### 请求参数
  190 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
  191 +|:-------| -----:|-----:|-----:|-----:|----:|
  192 +|uid|int|是||0|用户id|
  193 +|limitProductCode|String|否||无||
  194 +
  195 +注意，通用的头部没有列出。
  196 +请求示例http://127.0.0.1:8080/gateway/?method=app.limitcode.query&uid=12710899
  197 +
  198 +### 响应
  199 +code为200即为成功，否则是失败。
  200 +```json
  201 +{
  202 + "alg": "SALT_MD5",
  203 + "code": 200,
  204 + "data":
  205 + {"alertFlag":true,
  206 +"attachment":
  207 +[{"attachName":"",
  208 +"attachType":1,
  209 +"attachUrl":"",
  210 +"id":25197,
  211 +"intro":"",
  212 +"isDefault":1,
  213 +"orderBy":1,
  214 +"productId":167,
  215 +"status":0},
  216 +"batchNo":"2016040718244343",
  217 +"defaultUrl":"http://img12.static.yhbimg.com/goodsimg/2016/04/19/11/028199c467efae8038f9705534c8277225.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",
  218 +"description":"",
  219 +"hotFlag":1,
  220 +"id":167,
  221 +"limitProductCode":"2016041911341815",
  222 +"limitProductType":1,
  223 +"oldSaleTime":1461297600,
  224 +"orderBy":9,
  225 +"colorName":"黑色",
  226 +"sizeName":"42码",
  227 +"selectSKU":"51187",
  228 +"setProductSKU":1,
  229 +"queueType":"1",
  230 +"price":"¥1099.00",
  231 +"productName":"大牌合作超强联手PUMA x McQ Brace Lo Femme White",
  232 +"productSkn":51162584,
  233 +"reminderNum":22702,
  234 +"saleStatus":0,
  235 +"saleTime":"2016年4月22日",
  236 +"shareUrl":"http://m.yohobuy.com/product/detail/limit?code=2016041911341815",
  237 +"showFlag":1,
  238 +"showStatus":6},
  239 +"md5":"19d342768d9ec4db0ab21bb5d96430df",
  240 +"message":"detail limitproduct info"
  241 +}
  242 +```