使用场景:
在权益配置的奖品选择发奖类型为 接口发奖(grant_prize_way=4,非自建应用方式) ,C端用户中奖领取该奖品,兔展侧会通过奖品配置的回调地址url通知企业
使用该功能接口前提,配置该奖品权益的租户(org_id)需要申请开通 内容开放平台(https://www.rabbitpre.com/openplatform/apply,作为申请开通的登录账号),
开通操作手册(https://doc.weixin.qq.com/doc/w3_AEkANAaaADI0fzygu6lRS6LLtvqaU?scode=AAIAAgd2AAw2DrXaZqAEkANAaaADI)
请求URL:第三方发奖接口提供
请求方式 :POST
consumes :application/json
produces :application/json
请求参数:
字段 | 类型 | 说明 |
appId | string | 兔展作品ID,一个uuid字符串 |
activityId | string | 奖品关联的玩法组件id(其他接口可能命名为componentId),一个uuid字符串 |
activityName | string | 奖品关联玩法名称 |
awardLevel | string | 奖品等级 |
orderId | string | C端用户中奖后在兔展平台生产的订单id |
billNo | string | 同订单id |
phone | string | 中奖用户手机号 |
openId | string | 中奖用户openId |
prizeId | string | 兔展侧奖品id |
prizeName | string | 兔展侧奖品名称 |
identities | List<Object> | 身份标识 |
signature | string | 签名信息,用来验证请求的有效性。算法代码请查阅该接口文档的底部评论区。针对获取到的Map<String,Object>参数键值对进行计算而生成的。 |
identities字段定义:
身份识别标识:
字段名 | 描述 | 类型 | 是否必须 |
---|---|---|---|
identityType | 标识类型 | String | |
identityId | 标识Id | String | |
fromTo | 标识来源 | String | |
platform | 标识来源平台 | String | |
openid | openid | String | 当 fromTo 为 gzh 时,openid有值 |
unionid | unionid | String | 当 fromTo 为 gzh 时,unionid有值 |
jcappId | 系统集成Id | String | |
appid | 微信appid | String | 可能是小程序appid,可能是公众号appid |
请求示例:
返回参数:
字段 | 类型 | 说明 |
---|---|---|
code | string | 响应code,200为成功 |
msg | string |
通知回调第三方需要有标识返回通知兔展 接口回调成功
response响应字段
兔展侧通过code字段来判断请求是否成功
评论
未知用户 (shangpan) 发表:
10月 23, 2023signature 值 ,签名算法(这个接口的签名算法和 根目录下的 内容开放平台的签名算法可能不一致)