渠道卡券主要是在站点后台定义好卡券
### 1.卡券渠道码
站点后台定义的卡券需要通过定义普通渠道发行 发可以发送给用户,可以定义多个发行渠道,每个渠道可以定义发行张数
具体的卡券定义,和渠道添加请参照 [马甲后台使用手册](http://help_for_magapp.mydoc.io/?t=173200)
![](https://box.kancloud.cn/f092f2e209cdc45c1155b35eb7ed4a9c_2366x1754.png)
我们这边需要的就是图上红线标注的渠道编码
### 2.加载渠道编码对应卡券的渠道信息
> http://客户端域名/mag/user/v1/card/loadPublishCard?code=b098e745c2f19c604d4281c7a8ae25d1&secret=xxxxxxxxx
#### 参数说明
| 名称 |类型|说明 |
| --- | -- |--- |
| code|string |卡券渠道码 |
| secret|string |后台设置的secret密钥 |
#### 返回实例
~~~
{
success: true,
code: 100,
msg: null,
data: {
card_name: "5元插件抵用券",
publish_name: "现场测试渠道核销",
left: 19,
begin_time: 1489593600,
end_time: 1489766400
}
}
~~~
#### 返回说明
| 名称 |类型|说明 |
| --- | -- |--- |
| card_name|string |卡券名称 |
| publish_name|string |渠道名称 |
| left|string |剩余数量 |
| end_time|string |渠道发行的截止时间 |
### 3.给用户发渠道号对应的卡券
> http://客户端域名/mag/user/v1/card/publishCardToUser?code=b098e745c2f19c604d4281c7a8ae25d1&user_id=5&secret=xxxxxxxxx
#### 参数说明
| 名称 |类型|说明 |
| --- | -- |--- |
| code|string |卡券渠道码 |
| user_id|int |用户id |
| secret|string |后台设置的secret密钥 |
#### 返回实例
~~~
{
success: true,
code: 100,
msg: null,
data: {
left: 15,
user_card_id: "1116"
}
}
~~~
#### 返回说明
| 名称 |类型|说明 |
| --- | -- |--- |
| left|string |剩余数量 |
| user_card_id|string |用户获取的卡的id |
### 4.卡的详情页面
>http://客户端域名/mag/user/v1/card/cardDetail?card_user_id=1116
链接对应这卡的详情页面
>注意当前是网页不需要添加上secret只有对应用户才可以查看