Authored by tanling

合格评价和地点签到场合,获取mars点数接口增加

@@ -44,3 +44,83 @@ code为200即为成功,否则是失败。 @@ -44,3 +44,83 @@ code为200即为成功,否则是失败。
44 "message": "uid为空!" 44 "message": "uid为空!"
45 } 45 }
46 ``` 46 ```
  47 +
  48 +## 2、收入mars点数##
  49 +
  50 +收入mars点数(method=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 +### 响应(data里所有的字段返回都是string类型)
  85 +code为200即为成功,否则是失败。
  86 +响应JSON格式如下所示:
  87 +```json
  88 +{
  89 + "alg": "SALT_MD5",
  90 + "code": 200,
  91 + "data": {
  92 + "code": 200,
  93 + "message": "success."
  94 + },
  95 + "md5": "012bd8dd78cc12fa3ec90722e5af55b5",
  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": 403,
  124 + "message": "marsId不能为空"
  125 +}
  126 +```