ttj1314 / API-Interfaces · Commits

Go to a project

Authored by huangping
Commit ac6c67ef106719b2732bd075423c5b59b87296be 1 parent 9bd2417b

Update 邀请好友赢福利.md

Inline Side-by-side
Showing 1 changed file with 36 additions and 381 deletions
1 -## 1、用户选择/修改活动商品的sku信息 ## 1 +## 1、活动首页 ##
  2 +活动首页。查询已经接受该用户的邀请的用户列表（?method=wap.invite.index）
2 3
3 -用户选择/修改活动商品的sku信息（?method=app.limitProduct.userChoiceSku）  
4 -#### 公共请求参数  
5 -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |  
6 -|:-------| -----:|-----:|-----:|-----:|-----:|----:|  
7 -|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|  
8 -|app_version|float|10|否|1||APP版本|  
9 -|os_version|string|20|否|Android4.4||系统版本+机器型号|  
10 -|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|  
11 -|screen_size|string|20|否|800x900||（手机尺寸）|  
12 #### 请求参数 4 #### 请求参数
13 -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | 5 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
14 |:-------| -----:|-----:|-----:|-----:|-----:|----:| 6 |:-------| -----:|-----:|-----:|-----:|-----:|----:|
15 -|uid|String|否|1-11|3566164||用户id|  
16 -|product_skn|String|否|1-11|50001796||skn|  
17 -|product_sku|String|否|1-11|102034||sku|  
18 -|product_skc|String|否|1-11|14||skc|  
19 -|color_name|String|否|1-50|黑||颜色|  
20 -|size_name|String|否|1-20|L||尺码|  
21 -|activity_id|String|否|1-5|111||活动id|  
22 -#### 接口说明  
23 -| 接口说明||  
24 -|:-------| -----:|  
25 -|请求域名|http://api.yoho.cn|  
26 -|接口名|app.limitProduct.userChoiceSku|  
27 -|接口说明|用户选择/修改活动商品的sku信息|  
28 -|http请求方式|POST/GET|  
29 -#### 返回错误  
30 -|错误code|错误提示|  
31 -|:-------| -----:|  
32 -|500|活动id为空|  
33 -|500|活动已结束，不可以修改颜色尺码|  
34 -|500|uid或productSkn不能为空|  
35 -|500|选择颜色尺码失败| 7 +|uid|int|否|50001796|0|用户id|
  8 +|activityId|int|否|50001796|0|活动id|
  9 +
  10 +### 请求示例
  11 +http://api.yoho.cn?method=wap.invite.index&uid=1&activityId=2
36 12
37 -注意，通用的头部没有列出。  
38 -请求示例  
39 -http://192.168.102.205:8080/gateway?uid=8039796&v=7&method=app.limitProduct.userChoiceSku&activity_id=111&uid=3566164&product_skn=50001796&product_sku=102034&product_skc=14&size_name=L&color_name=黑  
40 ### 响应 13 ### 响应
41 code为200即为成功，否则是失败。 14 code为200即为成功，否则是失败。
42 响应参数，data部分 15 响应参数，data部分
43 -响应成功JSON格式如下所示:  
44 -```json  
45 -{  
46 - "code": 200,  
47 - "message": "成功",  
48 - "md5": "6d729d4b35f10fc73531210bd7ecff91",  
49 - "alg": "SALT_MD5",  
50 - "data": []  
51 -}  
52 -```  
53 -响应失败JSON格式如下所示:  
54 -```json  
55 -{  
56 - "code": 500,  
57 - "message": "活动id为空",  
58 - "md5": "6d729d4b35f10fc73531210bd7ecff91",  
59 - "alg": "SALT_MD5",  
60 - "data": []  
61 -}  
62 -```  
63 -```json  
64 -{  
65 - "code": 500,  
66 - "message": "活动已结束,不可以修改颜色尺码",  
67 - "md5": "6d729d4b35f10fc73531210bd7ecff91",  
68 - "alg": "SALT_MD5",  
69 - "data": []  
70 -}  
71 -```  
72 16
73 -```json  
74 -{  
75 - "code": 500,  
76 - "message": "uid或productSkn不能为空",  
77 - "md5": "6d729d4b35f10fc73531210bd7ecff91",  
78 - "alg": "SALT_MD5",  
79 - "data": []  
80 -}  
81 -```  
82 -```json  
83 -{  
84 - "code": 500,  
85 - "message": "选择颜色尺码信息失败",  
86 - "md5": "6d729d4b35f10fc73531210bd7ecff91",  
87 - "alg": "SALT_MD5",  
88 - "data": []  
89 -}  
90 -```  
91 -  
92 -## 3、根据skn获取平台配置的sku的商品详细信息 ##  
93 -根据skn获取平台配置的sku的商品详细信息（?method=app.limitProduct.getLimitProductDataBySkn）  
94 -#### 公共请求参数  
95 -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |  
96 -|:-------| -----:|-----:|-----:|-----:|-----:|----:|  
97 -|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|  
98 -|app_version|float|10|否|1||APP版本|  
99 -|os_version|string|20|否|Android4.4||系统版本+机器型号|  
100 -|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|  
101 -|screen_size|string|20|否|800x900||（手机尺寸）|  
102 -#### 请求参数  
103 -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |  
104 -|:-------| -----:|-----:|-----:|-----:|-----:|----:|  
105 -|product_skn|String|否|1-11|50001796||用户id|  
106 -#### 接口说明  
107 -| 接口说明||  
108 -|:-------| -----:|  
109 -|请求域名|http://api.yoho.cn|  
110 -|接口名|app.limitProduct.getLimitProductDataBySkn|  
111 -|接口说明|获取平台配置的sku的商品详细信息|  
112 -|http请求方式|POST/GET|  
113 17
114 -#### 返回错误  
115 -|错误code|错误提示|  
116 -|:-------| -----:|  
117 -|500|product_skn不能为空|  
118 -|500|找不到商品对应的颜色尺码信息| 18 +| 参数名称 | 参数类型 | 示例 | 备注 |
  19 +|:-------| -----:|-----:|-----:|----:|
  20 +|id|int|123|主键id|
  21 +|uid|int|123|获取优惠券的好友的uid|
  22 +|shareUid|int|123|由谁发起分享的用户的uid|
  23 +|openId|string|adfadsf|获取优惠券的好友的第三方id|
  24 +|couponId|int|12345|优惠券id|
  25 +|couponCode|string|12345|优惠券码|
  26 +|couponAmount|BigDecimal|20|优惠券金额|
  27 +|activityId|int|20|活动|
  28 +|createTime|int|12121212121|领取时间（时间戳：秒数）|
  29 +|couponType|int|2|优惠券类型（1-新用户券，0-老用户券；2-分享者所得的券）|
  30 +|status|int|1|状态（0-未发券，1-已发券）|
  31 +|orderCode|int|1|订单编号|
119 32
120 -注意，通用的头部没有列出。  
121 -请求示例  
122 -http://192.168.102.205:8080/gateway?method=app.limitProduct.getLimitProductDataBySkn&debug=XYZ&product_skn=50001796  
123 -  
124 -### 响应  
125 -code为200即为成功，否则是失败。  
126 -响应参数，data部分  
127 响应成功JSON格式如下所示: 33 响应成功JSON格式如下所示:
128 ```json 34 ```json
129 { 35 {
130 "alg": "SALT_MD5", 36 "alg": "SALT_MD5",
131 "code": 200, 37 "code": 200,
132 - "data": {  
133 - "cn_alphabet": "",  
134 - "format_market_price": "¥275.00",  
135 - "format_sales_price": "0",  
136 - "goods_list": [  
137 - {  
138 - "color_id": 2,  
139 - "color_image": "http://img13.static.yhbimg.com/goodsimg/2012/03/02/17/0242814e14d8ac1525c92de0a84d0f70eb.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",  
140 - "color_name": "黑",  
141 - "goods_id": 14,  
142 - "images_list": [ ],  
143 - "is_default": "N",  
144 - "product_skc": 14,  
145 - "size_list": [  
146 - {  
147 - "order_by": 1169,  
148 - "product_sku": 102050,  
149 - "size_id": 201,  
150 - "size_name": "L",  
151 - "storage_number": 0  
152 - },  
153 - {  
154 - "order_by": 1163,  
155 - "product_sku": 102034,  
156 - "size_id": 211,  
157 - "size_name": "XL",  
158 - "storage_number": 0  
159 - }  
160 - ],  
161 - "status": 1  
162 - },  
163 - {  
164 - "color_id": 3,  
165 - "color_image": "http://img11.static.yhbimg.com/goodsimg/2012/03/02/15/01562d80dbd0f5acc9e8b96668836006ff.jpg?imageMogr2/thumbnail/{width}x{height}/extent/{width}x{height}/background/d2hpdGU=/position/center/quality/80",  
166 - "color_name": "灰",  
167 - "goods_id": 15,  
168 - "images_list": [ ],  
169 - "is_default": "Y",  
170 - "product_skc": 15,  
171 - "size_list": [  
172 - {  
173 - "order_by": 1175,  
174 - "product_sku": 102037,  
175 - "size_id": 203,  
176 - "size_name": "M",  
177 - "storage_number": 0  
178 - },  
179 - {  
180 - "order_by": 1169,  
181 - "product_sku": 102050,  
182 - "size_id": 201,  
183 - "size_name": "L",  
184 - "storage_number": 0  
185 - },  
186 - {  
187 - "order_by": 1163,  
188 - "product_sku": 102034,  
189 - "size_id": 211,  
190 - "size_name": "XL",  
191 - "storage_number": 0  
192 - }  
193 - ],  
194 - "status": 1  
195 - }  
196 - ],  
197 - "info": {  
198 - "comment_total": 0,  
199 - "consult_total": 0  
200 - },  
201 - "isLimitBuy": false,  
202 - "is_advance": "",  
203 - "is_collect": "",  
204 - "is_outlets": "",  
205 - "limitProductCode": "",  
206 - "market_price": 275,  
207 - "phrase": "OVERKILL OVK 08 CUTE SKULL 短袖TEE.正面胸口的图案和背后相互呼应，清新活力。超炫的骷髅图案，带来不一样的靓点 ",  
208 - "product_name": "OVERKILL OVK 08 CUTE SKULL 短袖TEE",  
209 - "product_skn": 50001796,  
210 - "product_url": "",  
211 - "saleStatus": 0,  
212 - "sales_phrase": "275",  
213 - "sales_price": 275,  
214 - "showStatus": 0,  
215 - "storage_sum": 0,  
216 - "vip": [  
217 - {  
218 - "caption": "银卡",  
219 - "price": "261.25"  
220 - },  
221 - {  
222 - "caption": "金卡",  
223 - "price": "247.50"  
224 - },  
225 - {  
226 - "caption": "白金",  
227 - "price": "242.00"  
228 - }  
229 - ],  
230 - "vip_price": "0.00",  
231 - "yohoCoinNum": "0"  
232 - }, 38 + "data": [{
  39 + "id" : 1,
  40 + "uid" : 2,
  41 + "shareUid" : 3,
  42 + "openId" : "adfasdf",
  43 + "couponId" : 12121,
  44 + "couponCode" : "asdgsdfg",
  45 + "couponAmount" : 20,
  46 + "activityId" : 4,
  47 + "createTime" : 1212134234,
  48 + "couponType" : 2,
  49 + "status" : 1,
  50 + "orderCode" : 7813491234
  51 + }],
233 "md5": "bc08c52373b36a0578293aa334176879", 52 "md5": "bc08c52373b36a0578293aa334176879",
234 "message": "success!" 53 "message": "success!"
235 } 54 }
236 ``` 55 ```
237 -## 4、参加SKU排队活动时检测APP版本号##  
238 -参加SKU排队活动时检测APP版本号（method=app.drawline.addQueue）  
239 -#### 公共请求参数  
240 -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |  
241 -|:-------| -----:|-----:|-----:|-----:|-----:|----:|  
242 -|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|  
243 -|app_version|float|10|否|1||APP版本|  
244 -|os_version|string|20|否|Android4.4||系统版本+机器型号|  
245 -|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|  
246 -|screen_size|string|20|否|800x900||（手机尺寸）|  
247 -#### 请求参数  
248 -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |  
249 -|:-------| -----:|-----:|-----:|-----:|----:|----:|  
250 -|activityId|Integer|1-5|否||无|活动id|  
251 -|app_version|String|1-10|否||无|版本号|  
252 -|uid|Integer|1-10|否||无||  
253 -|userType|Byte|1|是|1,2|1|用户类型(1真实用户，2马甲用户)|  
254 -|sort|Integer|1-7|是|||排队序号|  
255 -|limit|Integer|1-3|是|||分页大小|  
256 -#### 接口说明  
257 -| 接口说明||  
258 -|:-------| -----:|  
259 -|请求域名|http://api.yoho.cn|  
260 -|接口名|app.drawline.addQueue|  
261 -|接口说明|参加SKU排队活动时检测APP版本号息|  
262 -|http请求方式|POST/GET|  
263 -  
264 -注意，通用的头部没有列出。  
265 -请求示例http://127.0.0.1:8090/activity/?method=app.drawline.addQueue&app_version=4.0.1&uid=109&activityId=11  
266 -  
267 -### 响应  
268 -code为200即为成功，否则是失败。  
269 -响应JSON格式如下所示:  
270 -```json  
271 -{  
272 - "code": 900001006,  
273 - "message": "版本过低，请更新",  
274 - "md5": "f4a7a490bb6666b005008d795ed14e5d",  
275 - "alg": "SALT_MD5",  
276 - "data": {}  
277 -}  
278 -```  
279 -## 5、我的限购码##  
280 -我的限购码（method=app.limitcode.query）  
281 -#### 公共请求参数  
282 -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |  
283 -|:-------| -----:|-----:|-----:|-----:|-----:|----:|  
284 -|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|  
285 -|app_version|float|10|否|1||APP版本|  
286 -|os_version|string|20|否|Android4.4||系统版本+机器型号|  
287 -|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|  
288 -|screen_size|string|20|否|800x900||（手机尺寸）|  
289 -#### 请求参数  
290 -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |  
291 -|:-------| -----:|-----:|-----:|-----:|----:| ----:|  
292 -|uid|int|1-10|否||无|用户id|  
293 -#### 接口说明  
294 -| 接口说明||  
295 -|:-------| -----:|  
296 -|请求域名|http://api.yoho.cn|  
297 -|接口名|app.limitcode.query|  
298 -|接口说明|我的限购码|  
299 -|http请求方式|POST/GET|  
300 -  
301 -注意，通用的头部没有列出。  
302 -请求示例http://127.0.0.1:8080/gateway/?method=app.limitcode.query&uid=12710899  
303 -  
304 -### 响应  
305 -code为200即为成功，否则是失败。  
306 -```json  
307 -{  
308 - "alg": "SALT_MD5",  
309 - "code": 200,  
310 - "data": {  
311 - "invalidLimitCodeProducts": [],  
312 - "limitCodeProducts": [{  
313 -"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",  
314 -"limitCode":"2aD3U14L2",  
315 -"limitProductCode":"2016041511502657",  
316 -"price":"¥1499.00",  
317 -"productName":"大牌合作超强联手PUMA x McQ Brace Mid black强势来袭",  
318 -"productSkn":"51162585",  
319 -"productSku":"578965",  
320 -"color_name":"黑色"，  
321 -"size_name":"42码",  
322 -"status":"1"  
323 -}]  
324 - },  
325 - "md5": "3023b84ee63d9ea554cbbd0bf40fef62",  
326 - "message": "操作成功"  
327 -}  
328 -```  
329 -  
330 -## 6、限定商品详情##  
331 -限定商品详情（method=app.limitProduct.limitProductDetail）  
332 -#### 公共请求参数  
333 -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |  
334 -|:-------| -----:|-----:|-----:|-----:|-----:|----:|  
335 -|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|  
336 -|app_version|float|10|否|1||APP版本|  
337 -|os_version|string|20|否|Android4.4||系统版本+机器型号|  
338 -|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|  
339 -|screen_size|string|20|否|800x900||（手机尺寸）|  
340 -#### 请求参数  
341 -| 参数名称 | 参数类型 |长度 | 可否为空 | 示例 | 默认值 | 备注 |  
342 -|:-------| -----:|-----:|-----:|-----:|----:| ----:|  
343 -|uid|int|1-10|是||0|用户id|  
344 -|limitProductCode|String|1-20|否||无||  
345 -#### 接口说明  
346 -| 接口说明||  
347 -|:-------| -----:|  
348 -|请求域名|http://api.yoho.cn|  
349 -|接口名|app.limitProduct.limitProductDetail|  
350 -|接口说明|限定商品详情|  
351 -|http请求方式|POST/GET|  
352 -  
353 -注意，通用的头部没有列出。  
354 -请求示例http://127.0.0.1:8080/gateway/?method=app.limitProduct.limitProductDetail&uid=12710899&limitProductCode=2016022420292150  
355 -  
356 -### 响应  
357 -code为200即为成功，否则是失败。  
358 -```json  
359 -{  
360 - "alg": "SALT_MD5",  
361 - "code": 200,  
362 - "data":  
363 - {"alertFlag":true,  
364 -"attachment":  
365 -[{"attachName":"",  
366 -"attachType":1,  
367 -"attachUrl":"",  
368 -"id":25197,  
369 -"intro":"",  
370 -"isDefault":1,  
371 -"orderBy":1,  
372 -"productId":167,  
373 -"status":0},  
374 -"batchNo":"2016040718244343",  
375 -"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",  
376 -"description":"",  
377 -"hotFlag":1,  
378 -"id":167,  
379 -"limitProductCode":"2016041911341815",  
380 -"limitProductType":1,  
381 -"oldSaleTime":1461297600,  
382 -"orderBy":9,  
383 -"colorName":"黑色",  
384 -"sizeName":"42码",  
385 -"selectSKU":"51187",  
386 -"relatedSKU":true,  
387 -"queueType":"1",  
388 -"price":"¥1099.00",  
389 -"productName":"大牌合作超强联手PUMA x McQ Brace Lo Femme White",  
390 -"productSkn":51162584,  
391 -"reminderNum":22702,  
392 -"saleStatus":0,  
393 -"saleTime":"2016年4月22日",  
394 -"shareUrl":"http://m.yohobuy.com/product/detail/limit?code=2016041911341815",  
395 -"showFlag":1,  
396 -"showStatus":6},  
397 -"md5":"19d342768d9ec4db0ab21bb5d96430df",  
398 -"message":"detail limitproduct info"  
399 -}  
400 -```