Yoho-Documents / API-Interfaces · Commits

Go to a project

Authored by tanling
Commit 98b1702e63a89fd3434f9f8a3281b48c41039568 1 parent 997c01b9

移动marspoints中的接口文档

Inline Side-by-side
Showing 5 changed files with 689 additions and 690 deletions
1 -## 1、根据sso_id获取uid ##  
2 -  
3 -根据sso_id获取uid (method=app.passport.getUidback)  
4 -  
5 -  
6 -**公共请求参数**  
7 -  
8 -| 参数名称 | 参数类型| 长度 |可否为空 |示例 |默认值 | 备注 |  
9 -| ---------|:--------:| --------:|-----:|------:|-----:|------:|  
10 -|client_secret |string | 50 |否 |5ac68f20cb18efe154be | |进入接口提供的参数加密信息|  
11 -|app_version |float | 10 |否 |1 | |APP版本|  
12 -|os_version |string | 20 |否 |Android4.4 | |系统版本+机器型号|  
13 -|client_type |string | 20 |否 |iphone/android/ipad | |手机型号（不区分大小写）|  
14 -|screen_size |string | 20 |否 |800*900 | |(手机尺寸)|  
15 -  
16 -  
17 -**请求参数：**  
18 -  
19 -| 参数名称 | 参数类型 |可否为空 |示例 |默认值 | 备注 |  
20 -| ---------|:--------:| --------:|-----:|------:|-----:|  
21 -|ssoId |int | 否 |10059 |0 | |  
22 -  
23 -  
24 -注意，通用的头部没有列出。  
25 -  
26 -请求示例http://192.168.102.217:8080/gateway?method=app.passport.getUidback&ssoId=10059&debug=XYZ  
27 -  
28 -**响应（data里为int类型）**  
29 -  
30 - {  
31 - "alg": "SALT_MD5",  
32 - "code": 200,  
33 - "data": {  
34 - "ssoId": 10059,  
35 - "uid": 31  
36 - },  
37 - "md5": "23959c9afe34d9520bf69e014d459e78",  
38 - "message": "Uid info"  
39 - }  
40 -  
41 -  
42 - {  
43 - "code": 408,  
44 - "message": "sso_id不能为空"  
45 - }  
46 -  
47 -## 2、增加记录，获取生成用户id##  
48 -  
49 -增加记录，获取生成用户id（method=app.passport.addUserprofile）  
50 -  
51 -  
52 -**公共请求参数**  
53 -  
54 -| 参数名称 | 参数类型| 长度 |可否为空 |示例 |默认值 | 备注 |  
55 -| ---------|:--------:| --------:|-----:|------:|-----:|------:|  
56 -|client_secret |string | 50 |否 |5ac68f20cb18efe154be | |进入接口提供的参数加密信息|  
57 -|app_version |float | 10 |否 |1 | |APP版本|  
58 -|os_version |string | 20 |否 |Android4.4 | |系统版本+机器型号|  
59 -|client_type |string | 20 |否 |iphone/android/ipad | |手机型号（不区分大小写）|  
60 -|screen_size |string | 20 |否 |800*900 | |(手机尺寸)|  
61 -  
62 -**请求参数：**  
63 -  
64 -| 参数名称 | 参数类型 |可否为空 |示例 |默认值 | 备注 |  
65 -| ---------|:--------:| --------:|-----:|------:|-----:|  
66 -|ssoId |int | 否 |9852993 |- | |  
67 -|mobile |String | 是 |15212236292 | |电话号码 |  
68 -|email |String | 是 |152155@126.com | |用户邮箱 |  
69 -|password |String | 是 |min88111086 | |用户密码|  
70 -|areacode |String | 是 | | |用户地区编号|  
71 -  
72 -  
73 -注意，通用的头部没有列出。  
74 -  
75 -请求示例http://192.168.102.217:8080/gateway?method=app.passport.addUserprofile&debug=XYZ  
76 -  
77 -请求body  
78 -  
79 - {  
80 - "ssoId": 9852993,  
81 - "mobile": 15212236292,  
82 - "email": 152155@126.com ,  
83 - "password": min88111086,  
84 - "areacode":123  
85 - }  
86 -  
87 -**响应（data里为int类型）**  
88 -  
89 -code为200即为成功，否则是失败。 响应JSON格式如下所示:  
90 -  
91 - {  
92 - "alg": "SALT_MD5",  
93 - "code": 200,  
94 - "data": {  
95 - "ssoId": 9852993,  
96 - "uid": 8050256  
97 - },  
98 - "md5": "092120aa35acf86098caad0176a3c174",  
99 - "message": "Uid info"  
100 - }  
101 -  
102 -  
103 - {  
104 - "code": 408,  
105 - "message": "sso_id不能为空"  
106 - }  
107 -  
108 - {  
109 - "code": 405,  
110 - "message": "mobile与email不能都为空"  
111 - }  
112 -  
113 - {  
114 - "code": 403,  
115 - "message": "password不合法"  
116 - }  
  1 +## 2、增加记录，获取生成用户id##
  2 +
  3 +增加记录，获取生成用户id（method=app.passport.addUserprofile）
  4 +
  5 +
  6 +**公共请求参数**
  7 +
  8 +| 参数名称 | 参数类型| 长度 |可否为空 |示例 |默认值 | 备注 |
  9 +| ---------|:--------:| --------:|-----:|------:|-----:|------:|
  10 +|client_secret |string | 50 |否 |5ac68f20cb18efe154be | |进入接口提供的参数加密信息|
  11 +|app_version |float | 10 |否 |1 | |APP版本|
  12 +|os_version |string | 20 |否 |Android4.4 | |系统版本+机器型号|
  13 +|client_type |string | 20 |否 |iphone/android/ipad | |手机型号（不区分大小写）|
  14 +|screen_size |string | 20 |否 |800*900 | |(手机尺寸)|
  15 +
  16 +**请求参数：**
  17 +
  18 +| 参数名称 | 参数类型 |可否为空 |示例 |默认值 | 备注 |
  19 +| ---------|:--------:| --------:|-----:|------:|-----:|
  20 +|ssoId |int | 否 |9852993 |- | |
  21 +|mobile |String | 是 |15212236292 | |电话号码 |
  22 +|email |String | 是 |152155@126.com | |用户邮箱 |
  23 +|password |String | 是 |min88111086 | |用户密码|
  24 +|areacode |String | 是 | | |用户地区编号|
  25 +
  26 +
  27 +注意，通用的头部没有列出。
  28 +
  29 +请求示例http://192.168.102.217:8080/gateway?method=app.passport.addUserprofile&debug=XYZ
  30 +
  31 +请求body
  32 +
  33 + {
  34 + "ssoId": 9852993,
  35 + "mobile": 15212236292,
  36 + "email": 152155@126.com ,
  37 + "password": min88111086,
  38 + "areacode":123
  39 + }
  40 +
  41 +**响应（data里为int类型）**
  42 +
  43 +code为200即为成功，否则是失败。 响应JSON格式如下所示:
  44 +
  45 + {
  46 + "alg": "SALT_MD5",
  47 + "code": 200,
  48 + "data": {
  49 + "ssoId": 9852993,
  50 + "uid": 8050256
  51 + },
  52 + "md5": "092120aa35acf86098caad0176a3c174",
  53 + "message": "Uid info"
  54 + }
  55 +
  56 +
  57 + {
  58 + "code": 408,
  59 + "message": "sso_id不能为空"
  60 + }
  61 +
  62 + {
  63 + "code": 405,
  64 + "message": "mobile与email不能都为空"
  65 + }
  66 +
  67 + {
  68 + "code": 403,
  69 + "message": "password不合法"
  70 + }
  1 +## 1、根据sso_id获取uid ##
  2 +
  3 +根据sso_id获取uid (method=app.passport.getUidback)
  4 +
  5 +
  6 +**公共请求参数**
  7 +
  8 +| 参数名称 | 参数类型| 长度 |可否为空 |示例 |默认值 | 备注 |
  9 +| ---------|:--------:| --------:|-----:|------:|-----:|------:|
  10 +|client_secret |string | 50 |否 |5ac68f20cb18efe154be | |进入接口提供的参数加密信息|
  11 +|app_version |float | 10 |否 |1 | |APP版本|
  12 +|os_version |string | 20 |否 |Android4.4 | |系统版本+机器型号|
  13 +|client_type |string | 20 |否 |iphone/android/ipad | |手机型号（不区分大小写）|
  14 +|screen_size |string | 20 |否 |800*900 | |(手机尺寸)|
  15 +
  16 +
  17 +**请求参数：**
  18 +
  19 +| 参数名称 | 参数类型 |可否为空 |示例 |默认值 | 备注 |
  20 +| ---------|:--------:| --------:|-----:|------:|-----:|
  21 +|ssoId |int | 否 |10059 |0 | |
  22 +
  23 +
  24 +注意，通用的头部没有列出。
  25 +
  26 +请求示例http://192.168.102.217:8080/gateway?method=app.passport.getUidback&ssoId=10059&debug=XYZ
  27 +
  28 +**响应（data里为int类型）**
  29 +
  30 + {
  31 + "alg": "SALT_MD5",
  32 + "code": 200,
  33 + "data": {
  34 + "ssoId": 10059,
  35 + "uid": 31
  36 + },
  37 + "md5": "23959c9afe34d9520bf69e014d459e78",
  38 + "message": "Uid info"
  39 + }
  40 +
  41 +
  42 + {
  43 + "code": 408,
  44 + "message": "sso_id不能为空"
  45 + }
1 -## 1、获取有货币的总数(获取mars点数)##  
2 -  
3 -获取有货币的总数（method=app.yohocoin.total）  
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 -  
13 -#### 请求参数  
14 -| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |  
15 -|:-------| -----:|-----:|-----:|-----:|----:|  
16 -|uid|int|否|213|0|用户id|  
17 -  
18 -注意，通用的头部没有列出。  
19 -请求示例  
20 -http://192.168.102.217:8080/gateway?method=app.yohocoin.total&uid=50030141&debug=XYZ  
21 -  
22 -### 响应  
23 -code为200即为成功，否则是失败。  
24 -响应JSON格式如下所示:  
25 -```json  
26 -{  
27 - "alg": "SALT_MD5",  
28 - "code": 200,  
29 - "data": {  
30 - "code": "20111130-152530",  
31 - "total": 3000  
32 - },  
33 - "md5": "cb2b1d4baa0c099ff12797655ebaa128",  
34 - "message": "yoho coin total"  
35 -}  
36 -```  
37 -  
38 -```json  
39 -{  
40 - "alg": "SALT_MD5",  
41 - "code": 404,  
42 - "data": {},  
43 - "md5": "f4a7a490bb6666b005008d795ed14e5d",  
44 - "message": "uid为空！"  
45 -}  
46 -```  
47 -  
48 -## 2、收入mars点数##  
49 -  
50 -收入mars点数（method=app.marspoint.acquire）  
51 -#### 公共请求参数  
52 -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |  
53 -|:-------| -----:|-----:|-----:|-----:|-----:|----:|  
54 -|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|  
55 -|app_version|float|10|否|1||APP版本|  
56 -|os_version|string|20|否|Android4.4||系统版本+机器型号|  
57 -|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|  
58 -|screen_size|string|20|否|800x900||（手机尺寸）|  
59 -  
60 -#### 请求参数  
61 -| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |  
62 -|:-------| -----:|-----:|-----:|-----:|----:|  
63 -|uid|int|否|213|0|用户id|  
64 -|num|int|否|100|0|mars点数|  
65 -|type|int|否|17或者18|0|地点签到：17，合格评价：18|  
66 -|marsId|String|否|123456789|0|关联合格评价的具体评价，关联地点签到的具体地点|  
67 -|pid|int|是|100|0|erp操作人员的uid|  
68 -  
69 -注意，通用的头部没有列出。  
70 -请求示例  
71 -http://192.168.102.217:8080/gateway?method=app.marspoint.acquire&debug=XYZ  
72 -  
73 -入口参数body  
74 -```json  
75 -{  
76 - "uid": 50030199,  
77 - "num": 100,  
78 - "type": 18,  
79 - "marsId": 123456789,  
80 - "pid": 11111111  
81 -}  
82 -```  
83 -  
84 -### 响应  
85 -code为200即为成功，否则是失败。  
86 -响应JSON格式如下所示:  
87 -```json  
88 -{  
89 - "alg": "SALT_MD5",  
90 - "code": 200,  
91 - "data": {  
92 - "currency": "200",  
93 - "uid": 50030199  
94 - },  
95 - "md5": "a2f546011378a51fffc9f09e56ae6f22",  
96 - "message": "ok"  
97 -}  
98 -```  
99 -  
100 -```json  
101 -{  
102 - "code": 400,  
103 - "message": "请先登录"  
104 -}  
105 -```  
106 -  
107 -```json  
108 -{  
109 - "code": 402,  
110 - "message": "获取的mars点数不合法"  
111 -}  
112 -```  
113 -  
114 -```json  
115 -{  
116 - "code": 403,  
117 - "message": "type不合法"  
118 -}  
119 -```  
120 -  
121 -```json  
122 -{  
123 - "code": 405,  
124 - "message": "marsId不能为空"  
125 -}  
126 -```  
127 -  
128 -## 3、兑换mars点数##  
129 -  
130 -兑换mars点数（method=app.marspoint.exchange）  
131 -#### 公共请求参数  
132 -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |  
133 -|:-------| -----:|-----:|-----:|-----:|-----:|----:|  
134 -|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|  
135 -|app_version|float|10|否|1||APP版本|  
136 -|os_version|string|20|否|Android4.4||系统版本+机器型号|  
137 -|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|  
138 -|screen_size|string|20|否|800x900||（手机尺寸）|  
139 -  
140 -#### 请求参数  
141 -| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |  
142 -|:-------| -----:|-----:|-----:|-----:|----:|  
143 -|uid|int|否|213|0|用户id|  
144 -|num|int|否|-100|0|mars点数|  
145 -|type|int|否|19、20或21|0|兑换实物：19，兑换话费：20，兑换电子券:21|  
146 -|orderCode|String|否|123456789|0|订单号|  
147 -|pid|int|是|100|0|erp操作人员的uid|  
148 -  
149 -注意，通用的头部没有列出。  
150 -请求示例  
151 -http://192.168.102.217:8080/gateway?method=app.marspoint.exchange&debug=XYZ  
152 -  
153 -入口参数body  
154 -```json  
155 -{  
156 - "uid": 50030199,  
157 - "num": -150,  
158 - "type": 20,  
159 - "orderCode": 1234567890,  
160 - "pid": 11111111  
161 -}  
162 -```  
163 -  
164 -### 响应  
165 -code为200即为成功，否则是失败。  
166 -响应JSON格式如下所示:  
167 -```json  
168 -{  
169 - "alg": "SALT_MD5",  
170 - "code": 200,  
171 - "data": {  
172 - "currency": "200",  
173 - "uid": 50030199  
174 - },  
175 - "md5": "a2f546011378a51fffc9f09e56ae6f22",  
176 - "message": "ok"  
177 -}  
178 -```  
179 -  
180 -```json  
181 -{  
182 - "code": 400,  
183 - "message": "请先登录"  
184 -}  
185 -```  
186 -  
187 -```json  
188 -{  
189 - "code": 402,  
190 - "message": "获取的mars点数不合法"  
191 -}  
192 -```  
193 -  
194 -```json  
195 -{  
196 - "code": 403,  
197 - "message": "type不合法"  
198 -}  
199 -```  
200 -  
201 -```json  
202 -{  
203 - "code": 406,  
204 - "message": "orderCode不能为空"  
205 -}  
206 -```  
207 -  
208 -## 4、mars点数明细接口##  
209 -  
210 -mars点数（method=app.yohocoin.lists）  
211 -#### 公共请求参数  
212 -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |  
213 -|:-------| -----:|-----:|-----:|-----:|-----:|----:|  
214 -|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|  
215 -|app_version|float|10|否|1||APP版本|  
216 -|os_version|string|20|否|Android4.4||系统版本+机器型号|  
217 -|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|  
218 -|screen_size|string|20|否|800x900||（手机尺寸）|  
219 -  
220 -#### 请求参数  
221 -| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |  
222 -|:-------| -----:|-----:|-----:|-----:|----:|  
223 -|uid|int|否|213|0|用户id|  
224 -|page|int|是|2|1|页数|  
225 -|limit|int|是|20|20|每页的记录数|  
226 -|queryType|int|是|0|0|0-所有；1-收入；2-支出|  
227 -|beginTime|String|是|2016-05-18|0|开始时间|  
228 -|endTime|String|是|2016-05-18|0|结束时间|  
229 -  
230 -注意，通用的头部没有列出。  
231 -请求示例  
232 -有货币(mars points)明细:  
233 -http://192.168.102.217:8080/gateway?method=app.yohocoin.lists&uid=50030147&debug=XYZ  
234 -  
235 -### 响应  
236 -code为200即为成功，否则是失败。  
237 -响应JSON格式如下所示:  
238 -```json  
239 -{  
240 - "alg": "SALT_MD5",  
241 - "code": 200,  
242 - "data": {  
243 - "coinlist": [  
244 - {  
245 - "date": "2015-12-31 00:39:46",  
246 - "key": "10",  
247 - "message": "原有YOHO币10个，初始化变更",  
248 - "num": 1000,  
249 - "type": 1,  
250 - "title": "原有YOHO币%s个，初始化变更"  
251 - },  
252 - {  
253 - "date": "2015-12-21 19:18:40",  
254 - "key": "10",  
255 - "message": "订单取消退还：订单123456789",  
256 - "num": 1000,  
257 - "type": 2,  
258 - "title": "订单取消退还：订单%s"  
259 - },  
260 - {  
261 - "date": "2015-12-21 19:18:40",  
262 - "key": "10",  
263 - "message": "活动奖励",  
264 - "num": 1000,  
265 - "type": 3,  
266 - "title": "活动奖励"  
267 - },  
268 - {  
269 - "date": "2015-12-21 19:18:40",  
270 - "key": "10",  
271 - "message": "充值",  
272 - "num": -1000,  
273 - "type": 4,  
274 - "title": "充值"  
275 - },  
276 - {  
277 - "date": "2015-12-21 19:18:40",  
278 - "key": "10",  
279 - "message": "签到奖励",  
280 - "num": 1000,  
281 - "type": 5,  
282 - "title": "签到奖励"  
283 - },  
284 - {  
285 - "date": "2015-12-21 19:18:40",  
286 - "key": "10",  
287 - "message": "抽奖活动奖励",  
288 - "num": 1000,  
289 - "type": 6,  
290 - "title": "抽奖活动奖励"  
291 - },  
292 - {  
293 - "date": "2015-12-21 19:18:40",  
294 - "key": "10",  
295 - "message": "调研问卷奖励",  
296 - "num": 1000,  
297 - "type": 7,  
298 - "title": "调研问卷奖励"  
299 - },  
300 - {  
301 - "date": "2015-12-21 19:18:40",  
302 - "key": "10",  
303 - "message": "完善资料奖励",  
304 - "num": 1000,  
305 - "type": 8,  
306 - "title": "完善资料奖励"  
307 - },  
308 - {  
309 - "date": "2015-12-21 19:18:40",  
310 - "key": "10",  
311 - "message": "下单使用：订单123456789",  
312 - "num": -1000,  
313 - "type": 9,  
314 - "title": "下单使用：订单%s"  
315 - },  
316 - {  
317 - "date": "2015-12-21 19:18:40",  
318 - "key": "10",  
319 - "message": "退货退还：订单123456789",  
320 - "num": 10,  
321 - "type": 10,  
322 - "title": "退货退还：订单%s"  
323 - },  
324 - {  
325 - "date": "2015-12-21 19:18:40",  
326 - "key": "10",  
327 - "message": "活动赠送：订单123456789",  
328 - "num": 500,  
329 - "type": 11,  
330 - "title": "活动赠送：订单%s"  
331 - },  
332 - {  
333 - "date": "2015-12-21 19:18:40",  
334 - "key": "10",  
335 - "message": "抽奖使用",  
336 - "num": -50,  
337 - "type": 12,  
338 - "title": "抽奖使用"  
339 - },  
340 - {  
341 - "date": "2015-12-21 19:18:40",  
342 - "key": "10",  
343 - "message": "购买商品赠送：xxxx",  
344 - "num": -500,  
345 - "type": 13,  
346 - "title": "购买商品赠送：%s"  
347 - },  
348 - {  
349 - "date": "2015-12-21 19:18:40",  
350 - "key": "10",  
351 - "message": "晒单奖励：xxxxxx",  
352 - "num": 1000,  
353 - "type": 14,  
354 - "title": "购买商品赠送：%s"  
355 - },  
356 - {  
357 - "date": "2015-12-21 19:18:40",  
358 - "key": "10",  
359 - "message": "补差价：xxxxx",  
360 - "num": -50,  
361 - "type": 15,  
362 - "title": "补差价：%s"  
363 - },  
364 - {  
365 - "date": "2015-12-21 19:18:40",  
366 - "key": "10",  
367 - "message": "积分过期",  
368 - "num": -1000,  
369 - "type": 16,  
370 - "title": "积分过期"  
371 - },  
372 - {  
373 - "date": "2015-12-21 19:18:40",  
374 - "key": "10",  
375 - "message": "你今日已在\"costa咖啡奥体店\"完成签到",  
376 - "num": 1000,  
377 - "type": 17,  
378 - "title": "地点签到"  
379 - },  
380 - {  
381 - "date": "2015-12-21 19:18:40",  
382 - "key": "10",  
383 - "message": "xxx的酒吧可以看到黄浦江两边的超赞",  
384 - "num": 1000,  
385 - "type": 18,  
386 - "title": "合格评价"  
387 - },  
388 - {  
389 - "date": "2015-12-21 19:18:40",  
390 - "key": "10",  
391 - "message": "xxxxxxxxxx",  
392 - "num": -500,  
393 - "type": 19,  
394 - "title": "兑换实物"  
395 - },  
396 - {  
397 - "date": "2015-12-21 19:18:40",  
398 - "key": "10",  
399 - "message": "50元充值话费(中国移动/中国联通/中国电信)",  
400 - "num": -1000,  
401 - "type": 20,  
402 - "title": "兑换话费"  
403 - },  
404 - {  
405 - "date": "2015-12-21 19:18:40",  
406 - "key": "10",  
407 - "message": "xxxxxxxxx",  
408 - "num": -1000,  
409 - "type": 21,  
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点数兑换失败"  
419 - }  
420 - ],  
421 - "limit": 20,  
422 - "page": 1,  
423 - "page_total": 2,  
424 - "total": 2  
425 - },  
426 - "md5": "4d83a2697b11ba3faf4abf9133941502",  
427 - "message": "yoho coin list"  
428 -}  
429 -```  
430 -  
431 -```json  
432 -{  
433 - "alg": "SALT_MD5",  
434 - "code": 200,  
435 - "data": {  
436 - "coinlist": [  
437 - {  
438 - "date": "2016-05-20 11:30:32",  
439 - "message": "2016-03-16订单兑换失败，积分返还213415",  
440 - "num": 200,  
441 - "title": "mars点数兑换失败",  
442 - "type": 22  
443 - },  
444 - {  
445 - "date": "2016-05-20 11:28:47",  
446 - "message": "兑换电子卷53415",  
447 - "num": -200,  
448 - "title": "兑换电子券",  
449 - "type": 21  
450 - },  
451 - {  
452 - "date": "2016-05-20 11:28:03",  
453 - "message": "兑换话费2314",  
454 - "num": -50,  
455 - "title": "兑换话费",  
456 - "type": 20  
457 - },  
458 - {  
459 - "date": "2016-05-20 11:27:13",  
460 - "message": "兑换实物624",  
461 - "num": -100,  
462 - "title": "兑换实物",  
463 - "type": 19  
464 - },  
465 - {  
466 - "date": "2016-05-20 11:25:25",  
467 - "message": "2016-04-15在德吉完成签到5462",  
468 - "num": 300,  
469 - "title": "地点签到",  
470 - "type": 17  
471 - },  
472 - {  
473 - "date": "2016-05-20 11:24:44",  
474 - "message": "2016-04-15在黄山完成签到5132214",  
475 - "num": 200,  
476 - "title": "地点签到",  
477 - "type": 17  
478 - },  
479 - {  
480 - "date": "2016-05-20 11:23:08",  
481 - "message": "这是一条合格的评价214123",  
482 - "num": 100,  
483 - "title": "合格评价",  
484 - "type": 18  
485 - }  
486 - ],  
487 - "limit": 20,  
488 - "page": 1,  
489 - "page_total": 7,  
490 - "total": 7  
491 - },  
492 - "md5": "bdda1cb138535afc516aa4245eaf8699",  
493 - "message": "yoho coin list"  
494 -}  
495 -```  
496 -  
497 -## 5、兑换失败返回被使用的mars点数##  
498 -  
499 -兑换失败返回被使用的mars点数（method=app.marspoint.return）  
500 -#### 公共请求参数  
501 -| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |  
502 -|:-------| -----:|-----:|-----:|-----:|-----:|----:|  
503 -|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|  
504 -|app_version|float|10|否|1||APP版本|  
505 -|os_version|string|20|否|Android4.4||系统版本+机器型号|  
506 -|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|  
507 -|screen_size|string|20|否|800x900||（手机尺寸）|  
508 -  
509 -#### 请求参数  
510 -| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |  
511 -|:-------| -----:|-----:|-----:|-----:|----:|  
512 -|uid|int|否|213|0|用户id|  
513 -|num|int|否|100|0|mars点数|  
514 -|type|int|否|22|0|mars点数兑换失败：22|  
515 -|orderCode|String|否|123456789|0|订单号|  
516 -|pid|int|是|100|0|erp操作人员的uid|  
517 -  
518 -注意，通用的头部没有列出。  
519 -请求示例  
520 -http://192.168.102.217:8080/gateway?method=app.marspoint.return&debug=XYZ  
521 -  
522 -入口参数body  
523 -```json  
524 -{  
525 - "uid": 50030199,  
526 - "num": 150,  
527 - "type": 22,  
528 - "orderCode": 1234567890,  
529 - "pid": 11111111  
530 -}  
531 -```  
532 -  
533 -### 响应  
534 -code为200即为成功，否则是失败。  
535 -响应JSON格式如下所示:  
536 -```json  
537 -{  
538 - "alg": "SALT_MD5",  
539 - "code": 200,  
540 - "data": {  
541 - "currency": "200",  
542 - "uid": 50030199  
543 - },  
544 - "md5": "a2f546011378a51fffc9f09e56ae6f22",  
545 - "message": "ok"  
546 -}  
547 -```  
548 -  
549 -```json  
550 -{  
551 - "code": 400,  
552 - "message": "请先登录"  
553 -}  
554 -```  
555 -  
556 -```json  
557 -{  
558 - "code": 402,  
559 - "message": "获取的mars点数不合法"  
560 -}  
561 -```  
562 -  
563 -```json  
564 -{  
565 - "code": 403,  
566 - "message": "type不合法"  
567 -}  
568 -```  
569 -  
570 -```json  
571 -{  
572 - "code": 406,  
573 - "message": "orderCode不能为空"  
574 -} 1 +## 1、获取有货币的总数(获取mars点数)##
  2 +
  3 +获取有货币的总数（method=app.yohocoin.total）
  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 +
  13 +#### 请求参数
  14 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
  15 +|:-------| -----:|-----:|-----:|-----:|----:|
  16 +|uid|int|否|213|0|用户id|
  17 +
  18 +注意，通用的头部没有列出。
  19 +请求示例
  20 +http://192.168.102.217:8080/gateway?method=app.yohocoin.total&uid=50030141&debug=XYZ
  21 +
  22 +### 响应
  23 +code为200即为成功，否则是失败。
  24 +响应JSON格式如下所示:
  25 +```json
  26 +{
  27 + "alg": "SALT_MD5",
  28 + "code": 200,
  29 + "data": {
  30 + "code": "20111130-152530",
  31 + "total": 3000
  32 + },
  33 + "md5": "cb2b1d4baa0c099ff12797655ebaa128",
  34 + "message": "yoho coin total"
  35 +}
  36 +```
  37 +
  38 +```json
  39 +{
  40 + "alg": "SALT_MD5",
  41 + "code": 404,
  42 + "data": {},
  43 + "md5": "f4a7a490bb6666b005008d795ed14e5d",
  44 + "message": "uid为空！"
  45 +}
  46 +```
  47 +
  48 +## 2、收入有货币##
  49 +
  50 +收入mars点数（method=app.yohocoin.get）
  51 +#### 公共请求参数
  52 +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
  53 +|:-------| -----:|-----:|-----:|-----:|-----:|----:|
  54 +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|
  55 +|app_version|float|10|否|1||APP版本|
  56 +|os_version|string|20|否|Android4.4||系统版本+机器型号|
  57 +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|
  58 +|screen_size|string|20|否|800x900||（手机尺寸）|
  59 +
  60 +#### 请求参数
  61 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
  62 +|:-------| -----:|-----:|-----:|-----:|----:|
  63 +|uid|int|否|213|0|用户id|
  64 +|num|int|否|100|0|mars点数|
  65 +|type|int|否|17或者18|0|地点签到：17，合格评价：18|
  66 +|marsId|String|否|123456789|0|关联合格评价的具体评价，关联地点签到的具体地点|
  67 +|pid|int|是|100|0|erp操作人员的uid|
  68 +
  69 +注意，通用的头部没有列出。
  70 +请求示例
  71 +http://192.168.102.217:8080/gateway?method=app.yohocoin.get&debug=XYZ
  72 +
  73 +入口参数body
  74 +```json
  75 +{
  76 + "uid": 50030199,
  77 + "num": 100,
  78 + "type": 18,
  79 + "marsId": 123456789,
  80 + "pid": 11111111
  81 +}
  82 +```
  83 +
  84 +### 响应
  85 +code为200即为成功，否则是失败。
  86 +响应JSON格式如下所示:
  87 +```json
  88 +{
  89 + "alg": "SALT_MD5",
  90 + "code": 200,
  91 + "data": {
  92 + "currency": "200",
  93 + "uid": 50030199
  94 + },
  95 + "md5": "a2f546011378a51fffc9f09e56ae6f22",
  96 + "message": "ok"
  97 +}
  98 +```
  99 +
  100 +```json
  101 +{
  102 + "code": 400,
  103 + "message": "请先登录"
  104 +}
  105 +```
  106 +
  107 +```json
  108 +{
  109 + "code": 402,
  110 + "message": "获取的有货币不合法"
  111 +}
  112 +```
  113 +
  114 +```json
  115 +{
  116 + "code": 403,
  117 + "message": "type不合法"
  118 +}
  119 +```
  120 +
  121 +```json
  122 +{
  123 + "code": 405,
  124 + "message": "marsId不能为空"
  125 +}
  126 +```
  127 +
  128 +## 3、兑换mars点数##
  129 +
  130 +兑换mars点数（method=app.yohocoin.subtract）
  131 +#### 公共请求参数
  132 +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
  133 +|:-------| -----:|-----:|-----:|-----:|-----:|----:|
  134 +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|
  135 +|app_version|float|10|否|1||APP版本|
  136 +|os_version|string|20|否|Android4.4||系统版本+机器型号|
  137 +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|
  138 +|screen_size|string|20|否|800x900||（手机尺寸）|
  139 +
  140 +#### 请求参数
  141 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
  142 +|:-------| -----:|-----:|-----:|-----:|----:|
  143 +|uid|int|否|213|0|用户id|
  144 +|num|int|否|-100|0|mars点数|
  145 +|type|int|否|19、20或21|0|兑换实物：19，兑换话费：20，兑换电子券:21|
  146 +|orderCode|String|否|123456789|0|订单号|
  147 +|pid|int|是|100|0|erp操作人员的uid|
  148 +
  149 +注意，通用的头部没有列出。
  150 +请求示例
  151 +http://192.168.102.217:8080/gateway?method=app.yohocoin.subtract&debug=XYZ
  152 +
  153 +入口参数body
  154 +```json
  155 +{
  156 + "uid": 50030199,
  157 + "num": -150,
  158 + "type": 20,
  159 + "orderCode": 1234567890,
  160 + "pid": 11111111
  161 +}
  162 +```
  163 +
  164 +### 响应
  165 +code为200即为成功，否则是失败。
  166 +响应JSON格式如下所示:
  167 +```json
  168 +{
  169 + "alg": "SALT_MD5",
  170 + "code": 200,
  171 + "data": {
  172 + "currency": "200",
  173 + "uid": 50030199
  174 + },
  175 + "md5": "a2f546011378a51fffc9f09e56ae6f22",
  176 + "message": "ok"
  177 +}
  178 +```
  179 +
  180 +```json
  181 +{
  182 + "code": 400,
  183 + "message": "请先登录"
  184 +}
  185 +```
  186 +
  187 +```json
  188 +{
  189 + "code": 402,
  190 + "message": "获取的有货币不合法"
  191 +}
  192 +```
  193 +
  194 +```json
  195 +{
  196 + "code": 403,
  197 + "message": "type不合法"
  198 +}
  199 +```
  200 +
  201 +```json
  202 +{
  203 + "code": 406,
  204 + "message": "orderCode不能为空"
  205 +}
  206 +```
  207 +
  208 +## 4、有货币明细接口##
  209 +
  210 +mars点数（method=app.yohocoin.lists）
  211 +#### 公共请求参数
  212 +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
  213 +|:-------| -----:|-----:|-----:|-----:|-----:|----:|
  214 +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|
  215 +|app_version|float|10|否|1||APP版本|
  216 +|os_version|string|20|否|Android4.4||系统版本+机器型号|
  217 +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|
  218 +|screen_size|string|20|否|800x900||（手机尺寸）|
  219 +
  220 +#### 请求参数
  221 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
  222 +|:-------| -----:|-----:|-----:|-----:|----:|
  223 +|uid|int|否|213|0|用户id|
  224 +|page|int|是|2|1|页数|
  225 +|limit|int|是|20|20|每页的记录数|
  226 +|queryType|int|是|0|0|0-所有；1-收入；2-支出|
  227 +|beginTime|String|是|2016-05-18|0|开始时间|
  228 +|endTime|String|是|2016-05-18|0|结束时间|
  229 +
  230 +注意，通用的头部没有列出。
  231 +请求示例
  232 +有货币(mars points)明细:
  233 +http://192.168.102.217:8080/gateway?method=app.yohocoin.lists&uid=50030147&debug=XYZ
  234 +
  235 +### 响应
  236 +code为200即为成功，否则是失败。
  237 +响应JSON格式如下所示:
  238 +```json
  239 +{
  240 + "alg": "SALT_MD5",
  241 + "code": 200,
  242 + "data": {
  243 + "coinlist": [
  244 + {
  245 + "date": "2015-12-31 00:39:46",
  246 + "key": "10",
  247 + "message": "原有YOHO币10个，初始化变更",
  248 + "num": 1000,
  249 + "type": 1,
  250 + "title": "原有YOHO币%s个，初始化变更"
  251 + },
  252 + {
  253 + "date": "2015-12-21 19:18:40",
  254 + "key": "10",
  255 + "message": "订单取消退还：订单123456789",
  256 + "num": 1000,
  257 + "type": 2,
  258 + "title": "订单取消退还：订单%s"
  259 + },
  260 + {
  261 + "date": "2015-12-21 19:18:40",
  262 + "key": "10",
  263 + "message": "活动奖励",
  264 + "num": 1000,
  265 + "type": 3,
  266 + "title": "活动奖励"
  267 + },
  268 + {
  269 + "date": "2015-12-21 19:18:40",
  270 + "key": "10",
  271 + "message": "充值",
  272 + "num": -1000,
  273 + "type": 4,
  274 + "title": "充值"
  275 + },
  276 + {
  277 + "date": "2015-12-21 19:18:40",
  278 + "key": "10",
  279 + "message": "签到奖励",
  280 + "num": 1000,
  281 + "type": 5,
  282 + "title": "签到奖励"
  283 + },
  284 + {
  285 + "date": "2015-12-21 19:18:40",
  286 + "key": "10",
  287 + "message": "抽奖活动奖励",
  288 + "num": 1000,
  289 + "type": 6,
  290 + "title": "抽奖活动奖励"
  291 + },
  292 + {
  293 + "date": "2015-12-21 19:18:40",
  294 + "key": "10",
  295 + "message": "调研问卷奖励",
  296 + "num": 1000,
  297 + "type": 7,
  298 + "title": "调研问卷奖励"
  299 + },
  300 + {
  301 + "date": "2015-12-21 19:18:40",
  302 + "key": "10",
  303 + "message": "完善资料奖励",
  304 + "num": 1000,
  305 + "type": 8,
  306 + "title": "完善资料奖励"
  307 + },
  308 + {
  309 + "date": "2015-12-21 19:18:40",
  310 + "key": "10",
  311 + "message": "下单使用：订单123456789",
  312 + "num": -1000,
  313 + "type": 9,
  314 + "title": "下单使用：订单%s"
  315 + },
  316 + {
  317 + "date": "2015-12-21 19:18:40",
  318 + "key": "10",
  319 + "message": "退货退还：订单123456789",
  320 + "num": 10,
  321 + "type": 10,
  322 + "title": "退货退还：订单%s"
  323 + },
  324 + {
  325 + "date": "2015-12-21 19:18:40",
  326 + "key": "10",
  327 + "message": "活动赠送：订单123456789",
  328 + "num": 500,
  329 + "type": 11,
  330 + "title": "活动赠送：订单%s"
  331 + },
  332 + {
  333 + "date": "2015-12-21 19:18:40",
  334 + "key": "10",
  335 + "message": "抽奖使用",
  336 + "num": -50,
  337 + "type": 12,
  338 + "title": "抽奖使用"
  339 + },
  340 + {
  341 + "date": "2015-12-21 19:18:40",
  342 + "key": "10",
  343 + "message": "购买商品赠送：xxxx",
  344 + "num": -500,
  345 + "type": 13,
  346 + "title": "购买商品赠送：%s"
  347 + },
  348 + {
  349 + "date": "2015-12-21 19:18:40",
  350 + "key": "10",
  351 + "message": "晒单奖励：xxxxxx",
  352 + "num": 1000,
  353 + "type": 14,
  354 + "title": "购买商品赠送：%s"
  355 + },
  356 + {
  357 + "date": "2015-12-21 19:18:40",
  358 + "key": "10",
  359 + "message": "补差价：xxxxx",
  360 + "num": -50,
  361 + "type": 15,
  362 + "title": "补差价：%s"
  363 + },
  364 + {
  365 + "date": "2015-12-21 19:18:40",
  366 + "key": "10",
  367 + "message": "积分过期",
  368 + "num": -1000,
  369 + "type": 16,
  370 + "title": "积分过期"
  371 + },
  372 + {
  373 + "date": "2015-12-21 19:18:40",
  374 + "key": "10",
  375 + "message": "你今日已在\"costa咖啡奥体店\"完成签到",
  376 + "num": 1000,
  377 + "type": 17,
  378 + "title": "地点签到"
  379 + },
  380 + {
  381 + "date": "2015-12-21 19:18:40",
  382 + "key": "10",
  383 + "message": "xxx的酒吧可以看到黄浦江两边的超赞",
  384 + "num": 1000,
  385 + "type": 18,
  386 + "title": "合格评价"
  387 + },
  388 + {
  389 + "date": "2015-12-21 19:18:40",
  390 + "key": "10",
  391 + "message": "xxxxxxxxxx",
  392 + "num": -500,
  393 + "type": 19,
  394 + "title": "兑换实物"
  395 + },
  396 + {
  397 + "date": "2015-12-21 19:18:40",
  398 + "key": "10",
  399 + "message": "50元充值话费(中国移动/中国联通/中国电信)",
  400 + "num": -1000,
  401 + "type": 20,
  402 + "title": "兑换话费"
  403 + },
  404 + {
  405 + "date": "2015-12-21 19:18:40",
  406 + "key": "10",
  407 + "message": "xxxxxxxxx",
  408 + "num": -1000,
  409 + "type": 21,
  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点数兑换失败"
  419 + }
  420 + ],
  421 + "limit": 20,
  422 + "page": 1,
  423 + "page_total": 2,
  424 + "total": 2
  425 + },
  426 + "md5": "4d83a2697b11ba3faf4abf9133941502",
  427 + "message": "yoho coin list"
  428 +}
  429 +```
  430 +
  431 +```json
  432 +{
  433 + "alg": "SALT_MD5",
  434 + "code": 200,
  435 + "data": {
  436 + "coinlist": [
  437 + {
  438 + "date": "2016-05-20 11:30:32",
  439 + "message": "2016-03-16订单兑换失败，积分返还213415",
  440 + "num": 200,
  441 + "title": "mars点数兑换失败",
  442 + "type": 22
  443 + },
  444 + {
  445 + "date": "2016-05-20 11:28:47",
  446 + "message": "兑换电子卷53415",
  447 + "num": -200,
  448 + "title": "兑换电子券",
  449 + "type": 21
  450 + },
  451 + {
  452 + "date": "2016-05-20 11:28:03",
  453 + "message": "兑换话费2314",
  454 + "num": -50,
  455 + "title": "兑换话费",
  456 + "type": 20
  457 + },
  458 + {
  459 + "date": "2016-05-20 11:27:13",
  460 + "message": "兑换实物624",
  461 + "num": -100,
  462 + "title": "兑换实物",
  463 + "type": 19
  464 + },
  465 + {
  466 + "date": "2016-05-20 11:25:25",
  467 + "message": "2016-04-15在德吉完成签到5462",
  468 + "num": 300,
  469 + "title": "地点签到",
  470 + "type": 17
  471 + },
  472 + {
  473 + "date": "2016-05-20 11:24:44",
  474 + "message": "2016-04-15在黄山完成签到5132214",
  475 + "num": 200,
  476 + "title": "地点签到",
  477 + "type": 17
  478 + },
  479 + {
  480 + "date": "2016-05-20 11:23:08",
  481 + "message": "这是一条合格的评价214123",
  482 + "num": 100,
  483 + "title": "合格评价",
  484 + "type": 18
  485 + }
  486 + ],
  487 + "limit": 20,
  488 + "page": 1,
  489 + "page_total": 7,
  490 + "total": 7
  491 + },
  492 + "md5": "bdda1cb138535afc516aa4245eaf8699",
  493 + "message": "yoho coin list"
  494 +}
  495 +```
  496 +
  497 +## 5、兑换失败返回被使用的有货币##
  498 +
  499 +兑换失败返回被使用的mars点数（method=app.yohocoin.return）
  500 +#### 公共请求参数
  501 +| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
  502 +|:-------| -----:|-----:|-----:|-----:|-----:|----:|
  503 +|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|
  504 +|app_version|float|10|否|1||APP版本|
  505 +|os_version|string|20|否|Android4.4||系统版本+机器型号|
  506 +|client_type|string|20|否|iphone/android/ipad||手机型号（不区分大小写）|
  507 +|screen_size|string|20|否|800x900||（手机尺寸）|
  508 +
  509 +#### 请求参数
  510 +| 参数名称 | 参数类型 | 可否为空 | 示例 | 默认值 | 备注 |
  511 +|:-------| -----:|-----:|-----:|-----:|----:|
  512 +|uid|int|否|213|0|用户id|
  513 +|num|int|否|100|0|mars点数|
  514 +|type|int|否|22|0|mars点数兑换失败：22|
  515 +|orderCode|String|否|123456789|0|订单号|
  516 +|pid|int|是|100|0|erp操作人员的uid|
  517 +
  518 +注意，通用的头部没有列出。
  519 +请求示例
  520 +http://192.168.102.217:8080/gateway?method=app.yohocoin.return&debug=XYZ
  521 +
  522 +入口参数body
  523 +```json
  524 +{
  525 + "uid": 50030199,
  526 + "num": 150,
  527 + "type": 22,
  528 + "orderCode": 1234567890,
  529 + "pid": 11111111
  530 +}
  531 +```
  532 +
  533 +### 响应
  534 +code为200即为成功，否则是失败。
  535 +响应JSON格式如下所示:
  536 +```json
  537 +{
  538 + "alg": "SALT_MD5",
  539 + "code": 200,
  540 + "data": {
  541 + "currency": "200",
  542 + "uid": 50030199
  543 + },
  544 + "md5": "a2f546011378a51fffc9f09e56ae6f22",
  545 + "message": "ok"
  546 +}
  547 +```
  548 +
  549 +```json
  550 +{
  551 + "code": 400,
  552 + "message": "请先登录"
  553 +}
  554 +```
  555 +
  556 +```json
  557 +{
  558 + "code": 402,
  559 + "message": "获取的有货币不合法"
  560 +}
  561 +```
  562 +
  563 +```json
  564 +{
  565 + "code": 403,
  566 + "message": "type不合法"
  567 +}
  568 +```
  569 +
  570 +```json
  571 +{
  572 + "code": 406,
  573 + "message": "orderCode不能为空"
  574 +}
575 ``` 575 ```