营销活动参与申请
1 接口说明
P云为接口提供方，用于发放奖励。
会进行重复参与活动判断：
- 当
voucher为空时，event_id+identity标识唯一记录； - 否则，
event_id+voucher作为请求发起方的唯一标记。
2 请求地址
POST https://api.4pyun.com/gate/1.0/bonus/event/apply
测试环境：https://dev-api.4pyun.com/gate/1.0/bonus/event/apply
3 请求方式
HTTP POST，form 表单提交。
4 请求参数
| 字段 | 类型 | 必须 | 说明 |
|---|---|---|---|
| event_id | string | Y | 活动编号,由P云分配 |
| identity | string | Y | 用户ID,登录授权获取 |
| app_id | string | Y | 应用ID,由P云分配 |
| openid | string | N | 微信/支付宝OPENID |
| fields | object | N | 申请表内容。当合作方实现了回调时，需填充key为user_code, value为合作方用户标识的键值对 |
| issuer | string | N | 发放人 |
| voucher | string | N | 凭证,例如业务订单号 |
| mobile | string | N | 手机号应答参数 |
5 响应参数
| 字段 | 类型 | 必须 | 说明 |
|---|---|---|---|
| bonus | array[object] | Y | 活动奖励 |
bonus
| 字段 | 类型 | 必须 | 说明 |
|---|---|---|---|
| id | int64 | Y | 奖励ID |
| cover | string | N | 奖励封面 |
| name | string | N | 奖励名称 |
| value | int32 | Y | 奖励面额，单位分 |
| quantity | int32 | N | 奖励数量 |
| status | int32 | Y | 奖励状态,0未发放 |
| remark | string | N | 备注 |
| issuer | string | N | 发放人 |
| identity | string | N | 领取用户ID |
6 错误码
见附录 - 错误码。