Authored by tanling

兑换失败返回被使用的mars点数 接口

@@ -89,10 +89,10 @@ code为200即为成功,否则是失败。 @@ -89,10 +89,10 @@ code为200即为成功,否则是失败。
89 "alg": "SALT_MD5", 89 "alg": "SALT_MD5",
90 "code": 200, 90 "code": 200,
91 "data": { 91 "data": {
92 - "code": 200,  
93 - "message": "success." 92 + "currency": "200",
  93 + "uid": 50030199
94 }, 94 },
95 - "md5": "012bd8dd78cc12fa3ec90722e5af55b5", 95 + "md5": "a2f546011378a51fffc9f09e56ae6f22",
96 "message": "ok" 96 "message": "ok"
97 } 97 }
98 ``` 98 ```
@@ -169,10 +169,10 @@ code为200即为成功,否则是失败。 @@ -169,10 +169,10 @@ code为200即为成功,否则是失败。
169 "alg": "SALT_MD5", 169 "alg": "SALT_MD5",
170 "code": 200, 170 "code": 200,
171 "data": { 171 "data": {
172 - "code": 200,  
173 - "message": "success." 172 + "currency": "200",
  173 + "uid": 50030199
174 }, 174 },
175 - "md5": "012bd8dd78cc12fa3ec90722e5af55b5", 175 + "md5": "a2f546011378a51fffc9f09e56ae6f22",
176 "message": "ok" 176 "message": "ok"
177 } 177 }
178 ``` 178 ```
@@ -408,6 +408,14 @@ code为200即为成功,否则是失败。 @@ -408,6 +408,14 @@ code为200即为成功,否则是失败。
408 "num": -1000, 408 "num": -1000,
409 "type": 21, 409 "type": 21,
410 "title": "兑换电子券" 410 "title": "兑换电子券"
  411 + },
  412 + {
  413 + "date": "2015-12-21 19:18:40",
  414 + "key": "10",
  415 + "message": "mars点数兑换失败",
  416 + "num": 1000,
  417 + "type": 22,
  418 + "title": "mars点数兑换失败"
411 } 419 }
412 ], 420 ],
413 "limit": 20, 421 "limit": 20,
@@ -420,4 +428,82 @@ code为200即为成功,否则是失败。 @@ -420,4 +428,82 @@ code为200即为成功,否则是失败。
420 } 428 }
421 ``` 429 ```
422 430
  431 +## 5、兑换失败返回被使用的mars点数##
  432 +
  433 +兑换失败返回被使用的mars点数(method=app.marspoint.return)
  434 +#### 公共请求参数
  435 +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
  436 +|:-------| -----:|-----:|-----:|-----:|-----:|----:|
  437 +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|
  438 +|app_version|float|10|否|1||APP版本|
  439 +|os_version|string|20|否|Android4.4||系统版本+机器型号|
  440 +|client_type|string|20|否|iphone/android/ipad||手机型号(不区分大小写)|
  441 +|screen_size|string|20|否|800x900||(手机尺寸)|
  442 +
  443 +#### 请求参数
  444 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
  445 +|:-------| -----:|-----:|-----:|-----:|----:|
  446 +|uid|int|否|213|0|用户id|
  447 +|num|int|否|100|0|mars点数|
  448 +|type|int|否|17或者18|0|mars点数兑换失败:22|
  449 +|orderCode|String|否|123456789|0|订单号|
  450 +|pid|int|是|100|0|erp操作人员的uid|
  451 +
  452 +注意,通用的头部没有列出。
  453 +请求示例
  454 +http://192.168.102.217:8080/gateway?method=app.marspoint.return&debug=XYZ
  455 +
  456 +入口参数body
  457 +```json
  458 +{
  459 + "uid": 50030199,
  460 + "num": 150,
  461 + "type": 22,
  462 + "orderCode": 1234567890,
  463 + "pid": 11111111
  464 +}
  465 +```
  466 +
  467 +### 响应
  468 +code为200即为成功,否则是失败。
  469 +响应JSON格式如下所示:
  470 +```json
  471 +{
  472 + "alg": "SALT_MD5",
  473 + "code": 200,
  474 + "data": {
  475 + "currency": "200",
  476 + "uid": 50030199
  477 + },
  478 + "md5": "a2f546011378a51fffc9f09e56ae6f22",
  479 + "message": "ok"
  480 +}
  481 +```
  482 +
  483 +```json
  484 +{
  485 + "code": 400,
  486 + "message": "请先登录"
  487 +}
  488 +```
  489 +
  490 +```json
  491 +{
  492 + "code": 402,
  493 + "message": "获取的mars点数不合法"
  494 +}
  495 +```
423 496
  497 +```json
  498 +{
  499 + "code": 403,
  500 + "message": "type不合法"
  501 +}
  502 +```
  503 +
  504 +```json
  505 +{
  506 + "code": 406,
  507 + "message": "orderCode不能为空"
  508 +}
  509 +```