接入说明
略
业务流程
sequenceDiagram
participant 用户
participant 业务前端
participant 业务后端
participant 公益服务
participant 公益小程序
用户->>业务前端: 访问页面
业务前端->>业务后端: 查询用户公益金领取与捐赠记录
业务后端->>公益服务: QueryUserActivityBonus(加密用户ID)
公益服务-->>业务后端: 返回领取与捐赠记录
业务后端-->>业务前端: 返回领取与捐赠记录
alt 需要展示领取链接
业务前端->>业务后端: 获取领取兑换码
业务后端->>公益服务: PreTry(加密用户ID)
公益服务-->>业务后端: 返回领取码
业务后端-->>业务前端: 返回加密用户ID和领取码
业务前端->>用户: 展示领取链接
用户->>公益小程序: 跳转领取公益金
end
调用接口
查询用户公益金领取情况
使用场景： 查询用户公益金领取和捐赠情况，可用于判断是否在业务前端展示跳转链接
调用凭证： 应用签名
请求方式： POST（HTTPS）
请求地址： https://test-oapi.gongyi.qq.com/api/bonus_donate_service/QueryUserActivityBonus
请求参数：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| open_id | string | 是 | 用户ID，可使用业务openID通过哈希映射的值 |
返回参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| activity_begin_time | uint32 | 活动开始时间 |
| activity_end_time | uint32 | 活动结束时间 |
| receive_transcode | string | 用户领取公益金的订单ID，为空则未领取公益金 |
| receive_time | int | 用户领取公益金时间 |
| donate_transcode | string | 用户捐赠公益金的订单ID，为空则未捐赠公益金 |
| donate_time | int | 用户捐赠公益金时间 |
获取公益金领取参数
使用场景： 获取公益金领取参数，用于拼接跳转到公益领取页面的链接
调用凭证： 应用签名
请求方式： POST（HTTPS）
请求地址： https://test-oapi.gongyi.qq.com/api/bonus_donate_service/PreTry
请求参数：
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
| open_id | string | 是 | 用户ID，可使用业务openID通过哈希映射的值 |
返回参数：
| 参数 | 类型 | 说明 |
|---|---|---|
| exchange_id | string | 公益金领取码 |