Authored by DengXinFei

pc

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 +```