版本比较

标识

  • 该行被添加。
  • 该行被删除。
  • 格式已经改变。

使用场景:

在权益配置的奖品选择发奖类型为  接口发奖(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

说明:在权益配置的奖品选择发奖类型为api发奖时,C端用户中奖领取该奖品,兔展侧会通过奖品配置的回调地址通知企业

注1:回调HTTP请求方式为POST

注2:签名方式参考公共参数签名鉴权

...

请求参数:


字段

 类型

说明

notifyId
appIdstring
回调通知id,唯一,用于重试
兔展作品ID,一个uuid字符串

activityId

string

奖品关联活动id

奖品关联的玩法组件id(其他接口可能命名为componentId),一个uuid字符串


activityName

string

j奖品关联活动名称

奖品关联玩法名称

awardLevel

string

奖品等级

orderId

string

关联订单id

C端用户中奖后在兔展平台生产的订单id

billNo

string

同订单id

phone

string

中奖用户手机号

openId

string

中奖用户openId

prizeId

string

兔展侧奖品id

prizeName

string

兔展侧奖品名称

originalId

string

第三方录入奖品id

prizeBat

int

奖品批次

subProjectId

string

兔展作品id

appId

string

OPFID

extendPrizeInfo

string

奖品扩展信息,格式为json

extendInfo

string

扩展信息

otherUserInfo

string

用户其他信息

通知回调第三方需要有标识返回通知兔展 接口回调成功

response响应字段

identitiesList<Object>身份标识
signature
string签名信息,用来验证请求的有效性。算法代码请查阅该接口文档的底部评论区。针对获取到的Map<String,Object>参数键值对进行计算而生成的。


identities字段定义:

身份识别标识:

字段名描述类型是否必须

identityType

标识类型

String


identityId标识IdString
fromTo标识来源String
platform标识来源平台String
openidopenidString当 fromTo 为 gzh 时,openid有值
unionidunionidString当 fromTo 为 gzh 时,unionid有值

jcappId

系统集成Id

String

appid

微信appidString可能是小程序appid,可能是公众号appid


请求示例:


返回参数:

...

字段类型说明
codestring响应code,200为成功
msgstring

通知回调第三方需要有标识返回通知兔展 接口回调成功

response响应字段

兔展侧通过code字段来判断请求是否成功

回调示例


逻辑时序图       如下所示:

Image Added