Yoho-Documents / API-Interfaces · Commits

Go to a project

Authored by tanling
Commit 3a72bc92207022938ef54c9e71a70a74cafbb285 1 parent f73dfdc9

有货币或者mars点数流水 接口增加

Inline Side-by-side
Showing 1 changed file with 221 additions and 4 deletions
@@ -19,7 +19,7 @@ @@ -19,7 +19,7 @@
19 请求示例 19 请求示例
20 http://192.168.102.217:8080/gateway?method=app.yohocoin.total&uid=50030141&debug=XYZ 20 http://192.168.102.217:8080/gateway?method=app.yohocoin.total&uid=50030141&debug=XYZ
21 21
22 -### 响应(data里所有的字段返回都是string类型) 22 +### 响应
23 code为200即为成功，否则是失败。 23 code为200即为成功，否则是失败。
24 响应JSON格式如下所示: 24 响应JSON格式如下所示:
25 ```json 25 ```json
@@ -81,7 +81,7 @@ http://192.168.102.217:8080/gateway?method=app.marspoint.acquire&debug=XYZ @@ -81,7 +81,7 @@ http://192.168.102.217:8080/gateway?method=app.marspoint.acquire&debug=XYZ
81 } 81 }
82 ``` 82 ```
83 83
84 -### 响应(data里所有的字段返回都是string类型) 84 +### 响应
85 code为200即为成功，否则是失败。 85 code为200即为成功，否则是失败。
86 响应JSON格式如下所示: 86 响应JSON格式如下所示:
87 ```json 87 ```json
@@ -125,7 +125,7 @@ code为200即为成功，否则是失败。 @@ -125,7 +125,7 @@ code为200即为成功，否则是失败。
125 } 125 }
126 ``` 126 ```
127 127
128 -## 2、兑换mars点数## 128 +## 3、兑换mars点数##
129 129
130 兑换mars点数（method=app.marspoint.exchange） 130 兑换mars点数（method=app.marspoint.exchange）
131 #### 公共请求参数 131 #### 公共请求参数
@@ -161,7 +161,7 @@ http://192.168.102.217:8080/gateway?method=app.marspoint.exchange&debug=XYZ @@ -161,7 +161,7 @@ http://192.168.102.217:8080/gateway?method=app.marspoint.exchange&debug=XYZ
161 } 161 }
162 ``` 162 ```
163 163
164 -### 响应(data里所有的字段返回都是string类型) 164 +### 响应
165 code为200即为成功，否则是失败。 165 code为200即为成功，否则是失败。
166 响应JSON格式如下所示: 166 响应JSON格式如下所示:
167 ```json 167 ```json
@@ -204,3 +204,220 @@ code为200即为成功，否则是失败。 @@ -204,3 +204,220 @@ code为200即为成功，否则是失败。
204 "message": "orderCode不能为空" 204 "message": "orderCode不能为空"
205 } 205 }
206 ``` 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 +http://192.168.102.217:8080/gateway?method=app.yohocoin.lists&uid=50030147&debug=XYZ
  233 +
  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 + "limit": 20,
  414 + "page": 1,
  415 + "page_total": 2,
  416 + "total": 2
  417 + },
  418 + "md5": "4d83a2697b11ba3faf4abf9133941502",
  419 + "message": "yoho coin list"
  420 +}
  421 +```
  422 +
  423 +