使用场景:
查询订单号对应的奖品领取状态
使用前提,自建应用需要开通-奖品-奖品订单状态查询 权限
查询订单号对应的,奖品状态
请求方式: GET
请求地址:https://integrate.rabbitpre.com/api/integrate/interest/getOrderPrizeInfo
consumes :application/json
produces :application/json
接口描述:
请求参数
...
请求头参数
参数名称 | 参数说明 | 请求类型 | 是否必须 | 数据类型 | schema |
---|---|---|---|---|---|
X-Token | 自建应用访问token | header | true | string |
请求体参数
字段名 | 描述 | 类型 | 是否必填 |
---|---|---|---|
orderId | 订单id | String | 是 。( |
中奖通知,传递的orderId,系统内部等价于字段prizeRecordId) |
请求实例
|
响应参数:
字段名 | 描述 | 类型 | 是否必填 |
---|---|---|---|
code | 结果返回码,200为正常,其余都为错误 | String | 是 |
msg | 结果描述 | String | 否 |
data | 结果 | Boolean | 是 |
data | |||
orderId | 订单Id | String | 是 |
status | 领奖状态 | String | 1:未领取 2:领取成功 3:领奖中 |
awardTime | 中奖时间 | String | yyyy-MM-dd HH:mm:ss |
appId | 作品id | String | 是 |
openid | openid | String | 微信环境,用户授权才有 |
unionid | unionid | String | 微信环境,用户授权才有 |
audid | 客户档案Id | String | 是 |
activityId | 活动Id | String | 是 |
identities | 身份标识 | List<Object> | 是 |
appId | 作品id | String | 是 |
appUrl | 作品链接 | String | 是 |
exchangeInfo | 兑奖信息(编辑器奖品选项设置) | Object | 编辑器设置了兑奖信息,才有 |
formInfo | 权益设置的表单信息采集项 | Object | 工作台,设置奖项采集信息,并且用户填写,才有 |
number | 奖品数量 | Int | 工作台,奖品设置数量 |
phone | 手机号列表 | List<String> | 客户档案,用户手机号列表 |
prizeName | 奖品名字 | String | 工作台,权益设置。奖品名称 |
prizeImg | 奖品图片 | String | 工作台,权益设置,奖品图片 |
prizeDetails | 奖品详情 | String | 工作台,权益设置,奖品详情 |
prizeUseRule | 奖品使用规则 | String | 工作台,权益设置,奖品使用规则 |
prizeId | 兔展奖品ID | String | 是。工作台,权益设置,创建奖品后生成的奖品唯一标识ID |
thirdPrizeId | 第三方奖品ID | String | 否。外部三方的奖品唯一标识ID,和兔展生成的奖品唯一标识ID 是一一映射关系,来自原于外部奖品导入时传给兔展进行记录 |
identities字段定义:
身份识别标识:
字段名 | 描述 | 类型 | 是否必须 |
---|---|---|---|
identityType | 标识类型 | String | 否,使用自建应用,身份识别才有 |
identityId | 标识Id | String | 否,使用自建应用,身份识别才有 |
fromTo | 标识来源 | String | 是 |
platform | 标识来源平台 | String | 是 |
openid | openid | String | 微信环境,用户授权才有 |
unionid | unionid | String | 微信环境,用户授权才有 |
exchangeInfo字段定义:
兑奖信息标识:
字段名 | 描述 | 类型 | 是否必须 |
---|---|---|---|
contact | 联系方式 | String | 编辑器。奖品兑奖信息设置 |
exchangeAddress | 兑奖地址 | String | 编辑器。奖品兑奖信息设置 |
exchangeDesc | 兑奖描述 | String | 编辑器。奖品兑奖信息设置 |
exchangeUrl | 兑奖线上地址 | String | 编辑器。奖品兑奖信息设置 |
operateTip | 操作提示 | String | 编辑器。奖品兑奖信息设置 |
orgName | 主办单位名称 | String | 是 |
contactLabel | 联系方式label值 | String | 编辑器。奖品兑奖信息设置 |
exchangeAddressLabel | 兑奖地址label值 | String | 编辑器。奖品兑奖信息设置 |
exchangeDescLabel | 兑奖描述label值 | String | 编辑器。奖品兑奖信息设置 |
formInfo字段定义:
兑奖信息标识:
字段名 | 描述 | 类型 | 是否必须 |
---|---|---|---|
data | 表单提交信息 | Map<String,String> | {"姓名":"张三"} |
响应实例:
代码块 |
---|
{ "code": "string200", "data": { "activityIderrorCode": "stringSUCCESS", "amountmsg": "stringok", "appIddata": "string", { "appUrlorderId": "string699639734053507072", "audid": "string", "awardTimestatus": "string2", "exchangeInfo": { "contactawardTime": "string2020-04-14 15:18:31", "exchangeAddressappId": "stringwx94ec6057d5a4a719", "exchangeDescopenid": "stringo7kepwTADYooArn--EVTHtKY811A", "exchangeUrlaudid": "string684066953765195776", "operateTipactivityId": "string699634741598621696", "orgNamethirdPrizeId": "string111111111", }, "formInfoidentities": {[ "data": {} },{ "identities": [ { "appidopenid": "stringo7kepwTADYooArn--EVTHtKY811A", "fromTo": "string", "identityIdunionid": "stringobGcFt4nz1jclUF4kO3vjEDobFAw", "identityType": "string", "jcappIdappid": "stringwx94ec6057d5a4a719", "openid": "string", "platform": "stringgzh", "unionid": "string" } } ], "numberphone": 0[], "openidprizeName": "stringtest3", "orderIdnumber": "string"32, "phoneamount": [ "22.00", "string""prizeImg": "//test-cdn1.rabbitpre.com/b5a46d9e-7b16-4ef4-8892-3e62cbe7eba0", ], "prizeNameprizeDetails": "string<p>33</p>", "statusprizeUseRule": "string33", "thirdPrizeIdexchangeInfo": "string"{}, "unionidformInfo": "string" {}, }, "errorCodeprizeId": "string699635574419623936", "msg": "string" } } |
错误码:
code | msg | 错误描述 |
---|---|---|
100100 | SYSTEM_ERROR | 请联系管理员 |
80009 | ORDER_NOT_EXIST | 订单不存在,请检查订单id |
80010 | ILLEGAL_ORDER_ID | 非法订单Id,请检查是不是当前Token对应的订单 |
80011 | PRIZE_DELETE | 奖品已被删除,请去工作台查看,是否奖品已被删除 |
80012 | ILLEGAL_PRIZE | 非法奖品,请检查该订单对应的奖品,是否是当前token对应的自建应用创建。 |
80014 | ILLEGAL_PARAM | 订单id为空,请检查orderId传值 |