Showing
1 changed file
with
627 additions
and
59 deletions
1 | -## 1、获取用户的验证信息 ## | 1 | +## 1、获取投诉数量 ## |
2 | + | ||
3 | +获取投诉数量(?method=web.complaints.getCount) | ||
4 | +#### 请求参数 | ||
5 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | | ||
6 | +|:-------| -----:|-----:|-----:|-----:|----:| | ||
7 | +|uid|int|否|3204031||用户id| | ||
8 | + | ||
9 | +注意,通用的头部没有列出。 | ||
10 | +请求示例 | ||
11 | +http://192.168.102.205:8080/gateway/?method=web.complaints.getCount&uid=3204031&client_type=web&client_secret=4bfdf461a964aa56d04a8927acc38363&app_version=1&v=1&os_version=1&client_secret=1&screen_size=1 | ||
12 | + | ||
13 | +### 响应 | ||
14 | +code为200即为成功,否则是失败。 | ||
15 | +响应参数,data部分 | ||
16 | + | ||
17 | +| 参数名称 | 参数类型 | 示例 | 默认值 | 备注 | | ||
18 | +|:-------| -----:|-----:|-----:|-----:| | ||
19 | +|count|int|20|0|投诉数量| | ||
20 | + | ||
21 | +响应JSON格式如下所示: | ||
22 | +```json | ||
23 | +{ | ||
24 | + "code": 200, | ||
25 | + "data": { | ||
26 | + "count": 24 | ||
27 | + }, | ||
28 | + "message": "成功" | ||
29 | +} | ||
30 | +``` | ||
31 | + | ||
32 | + | ||
33 | +## 2、获取投诉列表 ## | ||
34 | + | ||
35 | +获取投诉数量(?method=web.complaints.getList) | ||
36 | +#### 请求参数 | ||
37 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | | ||
38 | +|:-------| -----:|-----:|-----:|-----:|----:| | ||
39 | +|uid|int|否|3204031||用户id| | ||
40 | +|page|int|否|1|1|分页页码| | ||
41 | +|limit|int|否|10|10|分页大小| | ||
42 | + | ||
43 | +注意,通用的头部没有列出。 | ||
44 | + | ||
45 | +请求示例 | ||
46 | +http://192.168.102.205:8080/gateway/?method=web.complaints.getList&uid=3204031&page=1&limit=10&client_type=web&client_secret=20d26f1707b809bfa6e7a7a64af449c5&app_version=1&v=1&os_version=1&client_secret=1&screen_size=1 | ||
47 | + | ||
48 | +### 响应 | ||
49 | +code为200即为成功,否则是失败。 | ||
50 | + | ||
51 | +响应参数,data部分 : | ||
52 | + | ||
53 | +| 参数名称 | 参数类型 | 示例 | 默认值 | 备注 | | ||
54 | +|:-------| -----:|-----:|-----:|-----:| | ||
55 | +|page|int|||当前页码| | ||
56 | +|pageSize|int|||分页大小| | ||
57 | +|page_total|int|||总页数| | ||
58 | +|total|int|||总数大小| | ||
59 | +|complaintList|list|||我的投诉对象列表【见下面】| | ||
60 | + | ||
61 | +响应参数,complaintList部分[是个数组]: | ||
62 | + | ||
63 | +| 参数名称 | 参数类型 | 示例 | 默认值 | 备注 | | ||
64 | +|:-------| -----:|-----:|-----:|-----:| | ||
65 | +|complaintsType|int|1|0|投诉类型:0全部 1:产品相关 2:物流相关| | ||
66 | +|content|string|这是投诉内容|""|投诉内容| | ||
67 | +|createTime|string|2016-03-18 11:43:48|""|投诉时间| | ||
68 | +|customer|string|客服A|""|投诉对象| | ||
69 | +|id|int|18993|0|投诉id| | ||
70 | +|orderCode|string|9508684560|""|涉及的订单号| | ||
71 | +|pid|int|0|0|数据库的字段,没用| | ||
72 | +|reply|string|您好,如果有问题可以咨询4008899646或者在线客服处理,感谢您对有货的支持!|""|回复内容| | ||
73 | +|replyTime|string|2016-03-19 11:43:48|""|回复时间| | ||
74 | +|status|int|1|1|投诉的状态 1:正常,-1:自己取消| | ||
75 | +|title|string|这双鞋不能穿||投诉的标题| | ||
76 | +|uid|int|3204031||投诉人的uid| | ||
77 | + | ||
78 | +响应JSON格式如下所示: | ||
79 | +```json | ||
80 | +{ | ||
81 | + "code": 200, | ||
82 | + "data": { | ||
83 | + "complaintList": [ | ||
84 | + { | ||
85 | + "complaintsType": 1, | ||
86 | + "content": "content", | ||
87 | + "createTime": "2016-03-18 11:43:48", | ||
88 | + "customer": "customer", | ||
89 | + "id": 18993, | ||
90 | + "orderCode": "orderCode", | ||
91 | + "pid": 0, | ||
92 | + "reply": "", | ||
93 | + "replyTime": "", | ||
94 | + "status": 1, | ||
95 | + "title": "title", | ||
96 | + "uid": 3204031 | ||
97 | + }, | ||
98 | + { | ||
99 | + "complaintsType": 1, | ||
100 | + "content": "content", | ||
101 | + "createTime": "2016-03-17 08:33:35", | ||
102 | + "customer": "customer", | ||
103 | + "id": 18987, | ||
104 | + "orderCode": "orderCode", | ||
105 | + "pid": 0, | ||
106 | + "reply": "", | ||
107 | + "replyTime": "", | ||
108 | + "status": 1, | ||
109 | + "title": "title", | ||
110 | + "uid": 3204031 | ||
111 | + } | ||
112 | + ], | ||
113 | + "page": 1, | ||
114 | + "pageSize": 10, | ||
115 | + "page_total": 3, | ||
116 | + "total": 24 | ||
117 | + }, | ||
118 | + "message": "成功" | ||
119 | +} | ||
120 | +``` | ||
121 | + | ||
122 | +## 3、取消投诉 ## | ||
123 | + | ||
124 | +取消投诉(?method=web.complaints.cancel) | ||
125 | +#### 请求参数 | ||
126 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | | ||
127 | +|:-------| -----:|-----:|-----:|-----:|----:| | ||
128 | +|uid|int|否|3204031||用户id| | ||
129 | +|id|int|否|17||投诉id| | ||
130 | + | ||
131 | +注意,通用的头部没有列出。 | ||
132 | + | ||
133 | +请求示例 | ||
134 | +http://192.168.102.205:8080/gateway/?method=web.complaints.cancel&uid=3204031&id=17&client_type=web&client_secret=f22e55e7d9db4c575ae1f9f410a4dac8&app_version=1&v=1&os_version=1&client_secret=1&screen_size=1 | ||
135 | + | ||
136 | +### 响应 | ||
137 | +code为200即为成功,否则是失败。 | ||
138 | + | ||
139 | +响应JSON格式如下所示: | ||
140 | +```json | ||
141 | +{ | ||
142 | + "code": 200, | ||
143 | + "data": [], | ||
144 | + "message": "取消投诉成功" | ||
145 | +} | ||
146 | +``` | ||
147 | + | ||
148 | + | ||
149 | +## 4、新增投诉 ## | ||
150 | + | ||
151 | +新增投诉(?method=web.complaints.add) | ||
152 | +#### 请求参数 | ||
153 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | | ||
154 | +|:-------| -----:|-----:|-----:|-----:|----:| | ||
155 | +|uid|int|否|3204031||用户id| | ||
156 | +|title|string|否|你家鞋子不好||投诉标题,最长50| | ||
157 | +|customer|string|是|客服B||投诉对象,最长30| | ||
158 | +|complaintsType|int|否|1|0|投诉类型:0全部 1:产品相关 2:物流相关| | ||
159 | +|orderCode|string|否|9508684560||涉及的订单号| | ||
160 | +|content|string|否|这是投诉内容||投诉内容,最长255| | ||
161 | + | ||
162 | +注意,通用的头部没有列出。 | ||
163 | + | ||
164 | +请求示例 | ||
165 | +http://192.168.102.205:8080/gateway/?method=web.complaints.add&uid=3204031&title=title&customer=customer&complaintsType=1&orderCode=orderCode&content=content&client_type=web&client_secret=15dac0a8c9fb216cbd12d66155ec7bd5&app_version=1&v=1&os_version=1&client_secret=1&screen_size=1 | ||
166 | + | ||
167 | +### 响应 | ||
168 | +code为200即为成功,否则是失败。 | ||
169 | + | ||
170 | +响应JSON格式如下所示: | ||
171 | +```json | ||
172 | +{ | ||
173 | + "code": 200, | ||
174 | + "data": [], | ||
175 | + "message": "新增投诉成功" | ||
176 | +} | ||
177 | +``` | ||
178 | + | ||
179 | +## 5、PC帮助中心重构 ## | ||
180 | + | ||
181 | +获取帮助中心列表(?method=web.help.category) | ||
182 | + | ||
183 | +#### 请求参数 | ||
184 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | | ||
185 | +|:-------| -----:|-----:|-----:|-----:|----:| | ||
186 | +|caption|String|是|常见问题||帮助的标题| | ||
187 | + | ||
188 | +注意,通用的头部没有列出。 | ||
189 | +请求示例 | ||
190 | +http://192.168.102.205:8080/gateway/?method=web.help.category | ||
191 | + | ||
192 | +### 响应 | ||
193 | +code为200即为成功,否则是失败。 | ||
194 | + | ||
195 | +响应JSON格式如下所示: | ||
196 | +```json | ||
197 | +{ | ||
198 | + "code": 200, | ||
199 | + "data": [ | ||
200 | + { | ||
201 | + "caption": "常见问题", | ||
202 | + "id": 37 | ||
203 | + }, | ||
204 | + { | ||
205 | + "caption": "警惕网络诈骗公告", | ||
206 | + "id": 58 | ||
207 | + }, | ||
208 | + ], | ||
209 | + "message": "操作成功" | ||
210 | +} | ||
211 | +``` | ||
212 | + | ||
213 | +## 6、获取帮助中心内容 ## | ||
214 | + | ||
215 | +获取帮助中心内容(?method=web.help.getHelpDetailList) | ||
216 | +#### 请求参数 | ||
217 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | | ||
218 | +|:-------| -----:|-----:|-----:|-----:|----:| | ||
219 | +|category_id|String|否|37||帮助类别id| | ||
220 | +|problem|String|是|送货要多长时间||问题| | ||
221 | +|page|int|否|1|1|分页页码| | ||
222 | +|limit|int|否|10|10|分页大小| | ||
223 | + | ||
224 | +请求示例 | ||
225 | +http://192.168.102.205:8080/gateway/?method=web.help.getHelpDetailList&category_id=37 | ||
226 | + | ||
227 | +### 响应 | ||
228 | +code为200即为成功,否则是失败 | ||
229 | +响应JSON格式如下所示:。 | ||
230 | +响应参数,data部分 | ||
231 | +```json | ||
232 | +{ | ||
233 | + "code": 200, | ||
234 | + "data": { | ||
235 | + "helpdetail_list": [ | ||
236 | + { | ||
237 | + "answer": "您好,根据地域的不同,在您确认订购后的3-5天内我们会将货品送到。如果在您订购完成后7天内商品仍没有送达,您可以直接与YOHO!有货客服中心联系。需要说明的是:化妆品等液体商品,走的是陆运,会比普通商品晚2-3天左右,敬请谅解。如有任何疑问,请联系官网右上方的【在线客服】或致电客服热线:400-889-9646,我们将竭诚为您服务。", | ||
238 | + "problem": "送货要多长时间?" | ||
239 | + }, | ||
240 | + "message": "操作成功" | ||
241 | +} | ||
242 | +``` | ||
243 | + | ||
244 | +## 7、PC端帮助中心常见问题 ## | ||
245 | + | ||
246 | +PC端帮助中心常见问题(?method=web.help.getCommonFaqList) | ||
247 | + | ||
248 | +#### 请求参数 | ||
249 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | | ||
250 | +|:-------| -----:|-----:|-----:|-----:|----:| | ||
251 | +|category_id|String|否|37||帮助类别id| 以category_id为id去category查询的help_type不能是1 | ||
252 | +|problem|String|是|送货要多长时间||问题| | ||
253 | + | ||
254 | +请求示例 | ||
255 | +http://192.168.102.205:8080/gateway/?method=web.help.getCommonFaqList&category_id=37 | ||
256 | + | ||
257 | +### 响应 | ||
258 | +code为200即为成功,否则是失败 | ||
259 | +响应JSON格式如下所示:。 | ||
260 | +响应参数,data部分 | ||
261 | +```json | ||
262 | +{ | ||
263 | + "code": 200, | ||
264 | + "data": { | ||
265 | + "helpdetail_list": [ | ||
266 | + { | ||
267 | + "answer": "您好,根据地域的不同,在您确认订购后的3-5天内我们会将货品送到。如果在您订购完成后7天内商品仍没有送达,您可以直接与YOHO!有货客服中心联系。需要说明的是:化妆品等液体商品,走的是陆运,会比普通商品晚2-3天左右,敬请谅解。如有任何疑问,请联系官网右上方的【在线客服】或致电客服热线:400-889-9646,我们将竭诚为您服务。", | ||
268 | + "problem": "送货要多长时间?" | ||
269 | + }, | ||
270 | + "message": "操作成功" | ||
271 | +} | ||
272 | +``` | ||
273 | + | ||
274 | +## 8、兑换礼品卡 ## | ||
275 | + | ||
276 | +兑换礼品卡(?method=web.personCen.giftExchange) | ||
277 | + | ||
278 | +请求示例 | ||
279 | +http://127.0.0.1:8080/gateway/?method=web.personCen.giftExchange&uid=5687179&giftCardCode1=123&giftCardCode2=456&giftCardCode3=789&captchaCode=1234 | ||
280 | +#### 请求参数 | ||
281 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | | ||
282 | +giftCardCode1|String|否|兑换码1|4597 | ||
283 | +giftCardCode2|String|否|兑换码2|1365 | ||
284 | +giftCardCode3|String|否|兑换码3|7546 | ||
285 | +captchaCode|String|否|验证码|k754 | ||
286 | +uid|String|否|用户id|457 | ||
287 | + | ||
288 | +### 响应 | ||
289 | +code为200即为成功,否则是失败 | ||
290 | +响应JSON格式如下所示: | ||
291 | +```json | ||
292 | +{ | ||
293 | + "code": 200, | ||
294 | + "message": "礼品卡充值成功.", | ||
295 | + "data": { | ||
296 | + "denomination": 10000 | ||
297 | + }, | ||
298 | + "md5": "4129cb45c9e7001ff5b90d0e221a6d29" | ||
299 | +} | ||
300 | +``` | ||
301 | + | ||
302 | +## 9 获取用户信息 ## | ||
303 | + | ||
304 | +获取用户信息(?method=open.passport.get) | ||
305 | +#### 请求参数 | ||
306 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | | ||
307 | +|:-------| -----:|-----:|-----:|-----:|----:| | ||
308 | +|uid|int|否|5357305||用户id| | ||
309 | + | ||
310 | +注意,通用的头部没有列出。 | ||
311 | +请求示例 | ||
312 | +http://192.168.102.205:8080/gateway/?method=open.passport.get&uid=5357305 | ||
313 | + | ||
314 | +### 响应 | ||
315 | +code为200即为成功,否则是失败。 | ||
316 | + | ||
317 | +响应JSON格式如下所示:(与PHP返回一致) | ||
318 | +```json | ||
319 | +{ | ||
320 | + "code": 200, | ||
321 | + "data": { | ||
322 | + "data": { | ||
323 | + "YohocoinCount": 0, //有货币数量 | ||
324 | + "couponCount": 0, //优惠券数量 | ||
325 | + "head_ico": "", //头像 | ||
326 | + "messageCount": 0, //未读消息数 | ||
327 | + "orderCount": 10, //待处理订单数 | ||
328 | + "profile_name": "18****59670", //名称 | ||
329 | + "random": 1458380115.093, | ||
330 | + "refundCount": 0, //退换货数量 | ||
331 | + "token": "", | ||
332 | + "uid": 5357305, //用户id | ||
333 | + "vip": { //VIP信息 | ||
334 | + "curTotalCost": "0.0", | ||
335 | + "curVipInfo": { | ||
336 | + "commonDiscount": "1.0", | ||
337 | + "curLevel": "0", | ||
338 | + "needCost": "0.0", | ||
339 | + "nextLevel": "1", | ||
340 | + "premiumScops": [], | ||
341 | + "promotionDiscount": "1.0", | ||
342 | + "title": "普通会员" | ||
343 | + }, | ||
344 | + "curYearCost": "0.0", | ||
345 | + "curYearCostPer": "0", | ||
346 | + "fitTime": "1451053087", | ||
347 | + "nextVipInfo": { | ||
348 | + "commonDiscount": "0.95", | ||
349 | + "curLevel": "1", | ||
350 | + "needCost": "600.0", | ||
351 | + "nextLevel": "2", | ||
352 | + "premiumScops": ["1", "4","10","8","9"], | ||
353 | + "promotionDiscount": "0.95", | ||
354 | + "title": "银卡会员" | ||
355 | + }, | ||
356 | + "upgradeNeedCost": "600.0", //升级需要消费的数量 | ||
357 | + "upgradeNeedCostPer": "100", //升级需要消费的比例 | ||
358 | + "vipEndDay": "295", | ||
359 | + "vipEndTime": "1483885087", | ||
360 | + "vipRemainDays": "295", | ||
361 | + "vipStartTime": "1452349087" | ||
362 | + } | ||
363 | + }, | ||
364 | + "result": "1" | ||
365 | + }, | ||
366 | + "message": "User info" | ||
367 | +} | ||
368 | +``` | ||
369 | + | ||
370 | +## 10、PC重构--我的咨询 ## | ||
371 | + | ||
372 | +我的咨询(?method=web.personCen.buyConsult) | ||
373 | +#### 请求参数 | ||
374 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | | ||
375 | +|:-------| -----:|-----:|-----:|-----:|----:| | ||
376 | +|uid|string|否|12|0|用户id| | ||
377 | +|page|int|否|1|1|分页页码| | ||
378 | +|limit|int|否|10|10|分页大小| | ||
379 | + | ||
380 | +注意,通用的头部没有列出。 | ||
381 | +请求示例 | ||
382 | +http://127.0.0.1:8080/gateway/?method=web.personCen.buyConsult&uid=12 | ||
383 | + | ||
384 | +### 响应 | ||
385 | +code为200即为成功,否则是失败。 | ||
386 | + | ||
387 | +响应JSON格式如下所示: | ||
388 | +```json | ||
389 | +{ | ||
390 | + "code": 200, | ||
391 | + "data": { | ||
392 | + "consult_list": [ | ||
393 | + { | ||
394 | + "answer": "您好,这款衣服只有这一个颜色了,感谢您的关注。", | ||
395 | + "answerTime": 1309530731, | ||
396 | + "answerUserId": 1, | ||
397 | + "ask": "", | ||
398 | + "askTime": 1308711168, | ||
399 | + "askUserId": 12, | ||
400 | + "brandId": 63, | ||
401 | + "id": 4, | ||
402 | + "maxSortId": 2, | ||
403 | + "middleSortId": 19, | ||
404 | + "productId": 943, | ||
405 | + "productName": "K*facto.2y梭织肌理印花短袖西装", | ||
406 | + "skn": 50000116, | ||
407 | + "smallSortId": 122 | ||
408 | + } | ||
409 | + ], | ||
410 | + "page": 1, | ||
411 | + "page_total": 1, | ||
412 | + "total": 1 | ||
413 | + }, | ||
414 | + "message": "my consult list" | ||
415 | +} | ||
416 | +``` | ||
417 | + | ||
418 | + | ||
419 | + | ||
420 | +## 11、批量设置消息为已读 ## | ||
421 | + | ||
422 | +批量设置消息为已读(method=web.inbox.setread) | ||
423 | +#### 请求参数 | ||
424 | +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 | | ||
425 | +|:-------| -----:|-----:|-----:|-----:|-----:|----:| | ||
426 | +|ids|string||否|1,2,3||需要设置为已读的消息的id,以逗号分隔| | ||
427 | +|uid|string||否|123456|0|用户id| | ||
428 | + | ||
429 | +注意,通用的头部没有列出。 | ||
430 | +请求示例 | ||
431 | +http://127.0.0.1:8080/gateway?method=web.inbox.setread&uid=5088713&ids=9,10,11 | ||
432 | + | ||
433 | +### 响应 | ||
434 | +用户响应JSON格式如下所示: | ||
435 | +```json | ||
436 | +{ | ||
437 | + "code": 200, | ||
438 | + "data": { | ||
439 | + "code": 200, | ||
440 | + "message": "success." | ||
441 | + }, | ||
442 | + "message": "操作成功" | ||
443 | +} | ||
444 | +``` | ||
445 | +code为200即为成功,否则是失败。 | ||
446 | + | ||
447 | + | ||
448 | + | ||
449 | +## 12、获取用户的验证信息 ## | ||
2 | 450 | ||
3 | 获取用户的验证信息(method=web.passport.getUserVerifyInfo) | 451 | 获取用户的验证信息(method=web.passport.getUserVerifyInfo) |
4 | #### 请求参数 | 452 | #### 请求参数 |
@@ -40,7 +488,10 @@ code为200即为成功,否则是失败。 | @@ -40,7 +488,10 @@ code为200即为成功,否则是失败。 | ||
40 | } | 488 | } |
41 | ``` | 489 | ``` |
42 | 490 | ||
43 | -## 2、验证密码是否正确 ## | 491 | +---------- |
492 | + | ||
493 | + | ||
494 | +## 13、验证密码是否正确 ## | ||
44 | 495 | ||
45 | 验证密码是否正确(method=web.passport.verifyUserPwd) | 496 | 验证密码是否正确(method=web.passport.verifyUserPwd) |
46 | #### 请求参数 | 497 | #### 请求参数 |
@@ -70,7 +521,7 @@ code为200即为成功,否则是失败。 | @@ -70,7 +521,7 @@ code为200即为成功,否则是失败。 | ||
70 | 521 | ||
71 | ---------- | 522 | ---------- |
72 | 523 | ||
73 | -## 3、修改当前账号密码 ## | 524 | +## 14、修改当前账号密码 ## |
74 | 525 | ||
75 | 修改当前账号密码(method=web.passport.changePwd) | 526 | 修改当前账号密码(method=web.passport.changePwd) |
76 | #### 请求参数 | 527 | #### 请求参数 |
@@ -100,7 +551,7 @@ code为200即为成功,否则是失败。 | @@ -100,7 +551,7 @@ code为200即为成功,否则是失败。 | ||
100 | 551 | ||
101 | ---------- | 552 | ---------- |
102 | 553 | ||
103 | -## 4、发送短信验证码到手机 ## | 554 | +## 15、发送短信验证码到手机 ## |
104 | 555 | ||
105 | 发送短信验证码到手机(method=web.passport.sendcode) | 556 | 发送短信验证码到手机(method=web.passport.sendcode) |
106 | #### 请求参数 | 557 | #### 请求参数 |
@@ -127,7 +578,7 @@ code为200即为成功,否则是失败。 | @@ -127,7 +578,7 @@ code为200即为成功,否则是失败。 | ||
127 | 578 | ||
128 | ---------- | 579 | ---------- |
129 | 580 | ||
130 | -## 5、验证短信验证码是否正确 ## | 581 | +## 16、验证短信验证码是否正确 ## |
131 | 582 | ||
132 | 验证短信验证码是否正确(method=web.passport.checkcode) | 583 | 验证短信验证码是否正确(method=web.passport.checkcode) |
133 | #### 请求参数 | 584 | #### 请求参数 |
@@ -156,7 +607,7 @@ code为200即为成功,否则是失败。 | @@ -156,7 +607,7 @@ code为200即为成功,否则是失败。 | ||
156 | ---------- | 607 | ---------- |
157 | 608 | ||
158 | 609 | ||
159 | -## 6、修改验证手机前的检查 ## | 610 | +## 17、修改验证手机前的检查 ## |
160 | 611 | ||
161 | 修改验证的手机前的检查(method=web.passport.checkVerifyMobile) | 612 | 修改验证的手机前的检查(method=web.passport.checkVerifyMobile) |
162 | #### 请求参数 | 613 | #### 请求参数 |
@@ -164,10 +615,11 @@ code为200即为成功,否则是失败。 | @@ -164,10 +615,11 @@ code为200即为成功,否则是失败。 | ||
164 | |:-------| -----:|-----:|-----:|-----:|----:| | 615 | |:-------| -----:|-----:|-----:|-----:|----:| |
165 | |mobile|string|否|13912345678||手机号码| | 616 | |mobile|string|否|13912345678||手机号码| |
166 | |area|string|否|86||国家码| | 617 | |area|string|否|86||国家码| |
618 | +|uid|int|否|||用户id| | ||
167 | 619 | ||
168 | 注意,通用的头部没有列出。 | 620 | 注意,通用的头部没有列出。 |
169 | 请求示例 | 621 | 请求示例 |
170 | -http://127.0.0.1:8080/gateway?method=web.passport.checkVerifyMobile&area=86&mobile=13912345678 | 622 | +http://127.0.0.1:8080/gateway?method=web.passport.checkVerifyMobile&area=86&mobile=13912345678&uid=111 |
171 | 623 | ||
172 | ### 响应 | 624 | ### 响应 |
173 | code为200即为成功,否则是失败。 | 625 | code为200即为成功,否则是失败。 |
@@ -184,7 +636,7 @@ code为200即为成功,否则是失败。 | @@ -184,7 +636,7 @@ code为200即为成功,否则是失败。 | ||
184 | 636 | ||
185 | ---------- | 637 | ---------- |
186 | 638 | ||
187 | -## 7、修改验证的手机 ## | 639 | +## 18、修改验证的手机 ## |
188 | 640 | ||
189 | 修改验证的手机(method=web.passport.changeVerifyMobile) | 641 | 修改验证的手机(method=web.passport.changeVerifyMobile) |
190 | 调用该方法前,必须先要调用web.passport.checkVerifyMobile该接口做检查 | 642 | 调用该方法前,必须先要调用web.passport.checkVerifyMobile该接口做检查 |
@@ -217,7 +669,7 @@ code为200即为成功,否则是失败。 | @@ -217,7 +669,7 @@ code为200即为成功,否则是失败。 | ||
217 | 669 | ||
218 | ---------- | 670 | ---------- |
219 | 671 | ||
220 | -## 7、验证邮箱,发送邮件 ## | 672 | +## 19、验证邮箱,发送邮件 ## |
221 | 673 | ||
222 | 验证邮箱,发送邮件(method=web.passport.verifyEmail) | 674 | 验证邮箱,发送邮件(method=web.passport.verifyEmail) |
223 | #### 请求参数 | 675 | #### 请求参数 |
@@ -244,7 +696,7 @@ code为200即为成功,否则是失败。 | @@ -244,7 +696,7 @@ code为200即为成功,否则是失败。 | ||
244 | 696 | ||
245 | ---------- | 697 | ---------- |
246 | 698 | ||
247 | -## 8、找回密码,判断code是否有效 ## | 699 | +## 20、找回密码,判断code是否有效 ## |
248 | 700 | ||
249 | 找回密码,判断code是否有效(method=web.passport.checkCodeValid) | 701 | 找回密码,判断code是否有效(method=web.passport.checkCodeValid) |
250 | #### 请求参数 | 702 | #### 请求参数 |
@@ -270,7 +722,7 @@ code为200即为成功,否则是失败。 | @@ -270,7 +722,7 @@ code为200即为成功,否则是失败。 | ||
270 | 722 | ||
271 | ---------- | 723 | ---------- |
272 | 724 | ||
273 | -## 10、修改验证的邮箱 ## | 725 | +## 21、修改验证的邮箱 ## |
274 | 726 | ||
275 | 修改验证的邮箱(method=web.passport.changeEmail) | 727 | 修改验证的邮箱(method=web.passport.changeEmail) |
276 | #### 请求参数 | 728 | #### 请求参数 |
@@ -294,72 +746,188 @@ code为200即为成功,否则是失败。 | @@ -294,72 +746,188 @@ code为200即为成功,否则是失败。 | ||
294 | } | 746 | } |
295 | ``` | 747 | ``` |
296 | 748 | ||
297 | -## 11、获取个人信息## | ||
298 | 749 | ||
299 | -获取文章作者信息(?method=open.passport.get) | 750 | +---------- |
751 | +## 22、查询我的有货币列表 ## | ||
752 | + | ||
753 | +查询我的有货币列表(method=app.yohocoin.lists) | ||
300 | #### 请求参数 | 754 | #### 请求参数 |
301 | | 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | | 755 | | 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | |
302 | |:-------| -----:|-----:|-----:|-----:|----:| | 756 | |:-------| -----:|-----:|-----:|-----:|----:| |
303 | -|uid|int|否|5357305|0|用户id| | 757 | +|uid|int|否|123||用户id| |
758 | +|limit|int|是|10|10|查询多少条| | ||
759 | +|page|int|是|1|1|第几页(从第一页开始)| | ||
760 | +|queryType|int|是|1|0|查询类型(0-所有;1-收入;2-支出)| | ||
761 | +|beginTime|string|是|2015-12-12||查询开始时间(格式:yyyy-MM-dd)| | ||
762 | +|endTime|string|是|2015-12-22||查询结束时间(格式:yyyy-MM-dd)| | ||
304 | 763 | ||
305 | 注意,通用的头部没有列出。 | 764 | 注意,通用的头部没有列出。 |
306 | 请求示例 | 765 | 请求示例 |
307 | -http://192.168.102.205:8080/gateway/?method=open.passport.get&uid=5357305&debug=XYZ | 766 | +http://127.0.0.1:8081/gateway?method=app.yohocoin.lists&uid=123&queryType=1 |
308 | 767 | ||
309 | ### 响应 | 768 | ### 响应 |
310 | code为200即为成功,否则是失败。 | 769 | code为200即为成功,否则是失败。 |
311 | 770 | ||
312 | -响应JSON格式如下所示:(是按PHP代码返回的) | 771 | +用户响应JSON格式如下所示: |
313 | ```json | 772 | ```json |
314 | { | 773 | { |
315 | "code": 200, | 774 | "code": 200, |
316 | "data": { | 775 | "data": { |
317 | - "data": { | ||
318 | - "YohocoinCount": 0,//有货币数量 | ||
319 | - "couponCount": 0,//优惠券数量 | ||
320 | - "head_ico": "",//头像 | ||
321 | - "messageCount": 0,//未读消息数 | ||
322 | - "orderCount": 10,//待处理订单数 | ||
323 | - "profile_name": "18****59670",//名称 | ||
324 | - "random": 1458378392.046,//以前接口返回的,不知道啥用 | ||
325 | - "refundCount": 0,//退换货数量 | ||
326 | - "token": "",//以前的字段,现在没有 | ||
327 | - "uid": 5357305,//用户id | ||
328 | - "vip": { //用户vip信息 | ||
329 | - "curTotalCost": "0.0",//总消费 | ||
330 | - "curVipInfo": { //当前vip信息 | ||
331 | - "commonDiscount": "1.0", //普通折扣 | ||
332 | - "curLevel": "0", //当前等级 | ||
333 | - "needCost": "0.0",//需要花费多少 | ||
334 | - "nextLevel": "1",//下一等级 | ||
335 | - "premiumScops": [],//VIP权限 | ||
336 | - "promotionDiscount": "1.0",//促销折扣 | ||
337 | - "title": "普通会员"//VIP名称 | ||
338 | - }, | ||
339 | - "curYearCost": "0.0", //当年消费多少 | ||
340 | - "curYearCostPer": "0",//目前消费百分比 | ||
341 | - "fitTime": "1451053087",//以前的逻辑,是vipStartTime-15天 | ||
342 | - "nextVipInfo": {//下一等级VIP信息 | ||
343 | - "commonDiscount": "0.95", | ||
344 | - "curLevel": "1", | ||
345 | - "needCost": "600.0", | ||
346 | - "nextLevel": "2", | ||
347 | - "premiumScops": ["1","4","10","8","9"], | ||
348 | - "promotionDiscount": "0.95", | ||
349 | - "title": "银卡会员" | ||
350 | - }, | ||
351 | - "upgradeNeedCost": "600.0",//升级需要花费多少 | ||
352 | - "upgradeNeedCostPer": "100",//升级需要的百分比 | ||
353 | - "vipEndDay": "295",//VIP剩余多少天 | ||
354 | - "vipEndTime": "1483885087",//VIP结束时间 | ||
355 | - "vipRemainDays": "295",//VIP剩余多少天 | ||
356 | - "vipStartTime": "1452349087"//VIP开始时间 | ||
357 | - } | 776 | + "coinlist": [ |
777 | + { | ||
778 | + "date": "2015-12-30 20:18:59", | ||
779 | + "message": "充值", | ||
780 | + "num": 1 | ||
781 | + }, | ||
782 | + { | ||
783 | + "date": "2015-12-30 19:19:34", | ||
784 | + "message": "晒单奖励:", | ||
785 | + "num": 1 | ||
786 | + }, | ||
787 | + .... | ||
788 | + ], | ||
789 | + "limit": 20, | ||
790 | + "page": 1, | ||
791 | + "page_total": 11, | ||
792 | + "total": 11 | ||
793 | + }, | ||
794 | + "message": "yoho coin list" | ||
795 | +} | ||
796 | +``` | ||
797 | + | ||
798 | +---------- | ||
799 | +## 23、查询我的红包列表 ## | ||
800 | + | ||
801 | +查询我的红包列表(method=app.yoho.redpacketList) | ||
802 | +#### 请求参数 | ||
803 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | | ||
804 | +|:-------| -----:|-----:|-----:|-----:|----:| | ||
805 | +|uid|int|否|123||用户id| | ||
806 | + | ||
807 | +注意,通用的头部没有列出。 | ||
808 | +请求示例 | ||
809 | +http://127.0.0.1:8081/gateway?method=app.yoho.redpacketList&uid=123 | ||
810 | + | ||
811 | +### 响应 | ||
812 | +code为200即为成功,否则是失败。 | ||
813 | + | ||
814 | +用户响应JSON格式如下所示: | ||
815 | +```json | ||
816 | +{ | ||
817 | + "code": 200, | ||
818 | + "data": [ | ||
819 | + { | ||
820 | + "amount": 0.68, | ||
821 | + "endTime": "", | ||
822 | + "id": 851414, | ||
823 | + "remark": "加红包", | ||
824 | + "startTime": "" | ||
358 | }, | 825 | }, |
359 | - "result": "1" | 826 | + { |
827 | + "amount": 2.48, | ||
828 | + "endTime": "", | ||
829 | + "id": 851415, | ||
830 | + "remark": "加红包", | ||
831 | + "startTime": "" | ||
832 | + }, | ||
833 | + ..... | ||
834 | + ], | ||
835 | + "message": "操作成功" | ||
836 | +} | ||
837 | +``` | ||
838 | + | ||
839 | + | ||
840 | +---------- | ||
841 | +## 24、查询我的vip信息 ## | ||
842 | + | ||
843 | +查询我的VIP信息(method=app.passport.vip) | ||
844 | +#### 请求参数 | ||
845 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | | ||
846 | +|:-------| -----:|-----:|-----:|-----:|----:| | ||
847 | +|uid|int|否|123||用户id| | ||
848 | +|client_type|String|否|web||客户端类型(web,h5,android,ipad,iphone)| | ||
849 | + | ||
850 | +注意,通用的头部没有列出。 | ||
851 | +请求示例 | ||
852 | +http://127.0.0.1:8081/gateway?method=app.passport.vip&uid=123&client_type=iphone | ||
853 | + | ||
854 | +### 响应 | ||
855 | +code为200即为成功,否则是失败。 | ||
856 | + | ||
857 | +用户响应JSON格式如下所示: | ||
858 | +```json | ||
859 | +{ | ||
860 | + "code": 200, | ||
861 | + "data": { | ||
862 | + "current_total_cost": "0.00", | ||
863 | + "current_vip_level": "0", | ||
864 | + "current_vip_title": "普通会员", | ||
865 | + "current_year_cost": "0.00", | ||
866 | + "enjoy_preferential": [], | ||
867 | + "next_need_cost": 600, | ||
868 | + "next_vip_level": "1", | ||
869 | + "next_vip_title": "银卡会员", | ||
870 | + "upgrade_need_cost": "600.0", | ||
871 | + "vip_end_time": "1461136668", | ||
872 | + "vip_reach_time": "1428304668", | ||
873 | + "vip_start_time": "1429600668" | ||
360 | }, | 874 | }, |
361 | - "message": "User info" | 875 | + "message": "vip." |
876 | +} | ||
877 | +``` | ||
878 | + | ||
879 | + | ||
880 | +---------- | ||
881 | + | ||
882 | +## 25、发送验证邮件到邮箱 ## | ||
883 | + | ||
884 | +发送验证邮件到邮箱(method=web.passport.sendVerifyEmailInfo) | ||
885 | +#### 请求参数 | ||
886 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | | ||
887 | +|:-------| -----:|-----:|-----:|-----:|----:| | ||
888 | +|email|string|否|abcdef||待发送邮件的邮箱| | ||
889 | +|callback|string|否|abcdef||邮件中,点击的连接地址| | ||
890 | + | ||
891 | +注意,通用的头部没有列出。 | ||
892 | +请求示例 | ||
893 | +http://127.0.0.1:8081/gateway?method=web.passport.sendVerifyEmailInfo&email=abcdef&callback=xxxxxxxx | ||
894 | + | ||
895 | +### 响应 | ||
896 | +code为200即为成功,否则是失败。 | ||
897 | + | ||
898 | +用户响应JSON格式如下所示: | ||
899 | +```json | ||
900 | +{ | ||
901 | + "code": 200, | ||
902 | + "data": [], | ||
903 | + "message": "操作成功" | ||
362 | } | 904 | } |
363 | ``` | 905 | ``` |
364 | 906 | ||
907 | + | ||
365 | ---------- | 908 | ---------- |
909 | + | ||
910 | +## 26、检查该邮箱是否可以验证 ## | ||
911 | + | ||
912 | +检查该邮箱是否可以验证(method=web.passport.checkVerifyEmail) | ||
913 | +#### 请求参数 | ||
914 | +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 | | ||
915 | +|:-------| -----:|-----:|-----:|-----:|----:| | ||
916 | +|email|string|否|abcdef||待验证的邮箱| | ||
917 | +|uid|string|否|abcdef||用户id| | ||
918 | + | ||
919 | +注意,通用的头部没有列出。 | ||
920 | +请求示例 | ||
921 | +http://127.0.0.1:8081/gateway?method=web.passport.checkVerifyEmail&email=abcdef&uid=123 | ||
922 | + | ||
923 | +### 响应 | ||
924 | +code为200即为成功,否则是失败。 | ||
925 | + | ||
926 | +用户响应JSON格式如下所示: | ||
927 | +```json | ||
928 | +{ | ||
929 | + "code": 200, | ||
930 | + "data": [], | ||
931 | + "message": "操作成功" | ||
932 | +} | ||
933 | +``` |
-
Please register or login to post a comment