Authored by tanling

礼品卡

## 1、使用礼品卡##
使用礼品卡(method=app.giftcard.use)
#### 公共请求参数
| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|-----:|----:|
|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|
|app_version|float|10|否|1||APP版本|
|os_version|string|20|否|Android4.4||系统版本+机器型号|
|client_type|string|20|否|iphone/android/ipad||手机型号(不区分大小写)|
|screen_size|string|20|否|800x900||(手机尺寸)|
#### 请求参数
| 参数名称 | 参数类型 |长度| 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|-----:|----:|
|uid|String||否|50001678|empty string||
|cardCode|String||否|LPK00500000001|empty string|礼品卡卡号|
|changeAmount|BigDecimal||否|-345.89|empty string|使用金额|
|orderCode|long||否|12457895|empty string|订单号|
注意,通用的头部没有列出。
请求示例(将debug=XYZ换为通用头)
http://localhost:8090/gateway?method=app.giftcard.use&uid=500027364&cardCode=LPK00500000001&changeAmount=898.98&orderCode=178333333
成功时,否则是失败。响应JSON格式如下所示:
```json
{
"alg": "SALT_MD5",
"code": 200,
"data": [],
"md5": "f4a7a490bb6666b005008d795ed14e5d",
"message": "操作成功"
}
```
... ...
## 1、激活礼品卡##
激活礼品卡(method=app.giftcard.activate)
#### 公共请求参数
| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|-----:|----:|
|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|
|app_version|float|10|否|1||APP版本|
|os_version|string|20|否|Android4.4||系统版本+机器型号|
|client_type|string|20|否|iphone/android/ipad||手机型号(不区分大小写)|
|screen_size|string|20|否|800x900||(手机尺寸)|
#### 请求参数
| 参数名称 | 参数类型 |长度| 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|-----:|----:|
|uid|String||否|50001678|empty string||
|cardCode|String||否|LPK00500000001|empty string|礼品卡卡号|
|cardPwd|String||否|040c98cda4084447a694f92fec907d79:2hbKUhE8RMzjIG8MhIBXPzSLryk7juLl|empty string|礼品卡卡密|
注意,通用的头部没有列出。
请求示例(将debug=XYZ换为通用头)
http://localhost:8090/gateway?method=app.giftcard.activate&uid=500027364&cardCode=LPK00500000001&cardPwd=040c98cda4084447a694f92fec907d79:2hbKUhE8RMzjIG8MhIBXPzSLryk7juLl
激活成功时,否则是失败。响应JSON格式如下所示:
```json
{
"alg": "SALT_MD5",
"code": 200,
"data": [],
"md5": "f4a7a490bb6666b005008d795ed14e5d",
"message": "操作成功"
}
```
不合法情况,响应JSON格式可能有如下几种情况:
```json
{
"message": "礼品卡卡号不能为空",
"code": 403
}
{
"message": "礼品卡卡密不能为空",
"code": 402
}
{
"message": "uid不能为空",
"code": 403
}
{
"message": "礼品卡卡号或卡密不正确",
"code": 501
}
{
"message": "礼品卡已激活,请勿重复激活",
"code": 503
}
{
"message": "礼品卡未开卡,请联系客服",
"code": 502
}
```
\ No newline at end of file
... ...
## 1、退还礼品卡##
退还礼品卡(method=app.giftcard.refund)
#### 公共请求参数
| 参数名称 | 参数类型 | 长度 | 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|-----:|----:|
|client_secret|string|50|否|5ac68f20cb18efe154be||进入接口提供的参数加密信息|
|app_version|float|10|否|1||APP版本|
|os_version|string|20|否|Android4.4||系统版本+机器型号|
|client_type|string|20|否|iphone/android/ipad||手机型号(不区分大小写)|
|screen_size|string|20|否|800x900||(手机尺寸)|
#### 请求参数
| 参数名称 | 参数类型 |长度| 可否为空 | 示例 | 默认值 | 备注 |
|:-------| -----:|-----:|-----:|-----:|-----:|----:|
|uid|String||否|50001678|empty string||
|cardCode|String||否|LPK00500000001|empty string|礼品卡卡号|
|changeAmount|BigDecimal||否|345.89|empty string|退还金额|
|orderCode|long||否|12457895|empty string|订单号|
注意,通用的头部没有列出。
请求示例(将debug=XYZ换为通用头)
http://localhost:8090/gateway?method=app.giftcard.refund&uid=500027364&cardCode=LPK00500000001&changeAmount=898.98&orderCode=178333333
退还成功时,否则是失败。响应JSON格式如下所示:
```json
{
"alg": "SALT_MD5",
"code": 200,
"data": [],
"md5": "f4a7a490bb6666b005008d795ed14e5d",
"message": "操作成功"
}
```
... ...