文档中心 > API类目 > 淘宝互动平台开放招募

qimen.taobao.hudong.open.award.send (互动开放奖励发放)

互动开放招募 ISV,进行 ISV 游戏开发,平台促活。 使用奇门进行 ISV 互通发放游戏道具和游戏虚拟资产(如积分,道具,游戏时长等等)

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
channel String 必须 dft 发放渠道
strategy String 必须 random 发放策略
actionId String 必须 a2b3 幂等唯一 ID
type String 必须 gold 发放奖励类型
count Number 必须 123 发放数量
openId String 必须 1231 用户ID

响应参数

名称 类型 示例值 描述
bizCode String SUCCESS 成功返回 SUCCESS 可重试失败返回 FAIL_XXX 不可重试失败返回 ERR_XXX 系统错误原样返回
bizMsg String success 错误信息
success Boolean true 是否成功
type String sprite 奖品类型(可计算) 自定义 [a-zA-Z0-9]
count Number 1 奖品数量(可计算数值)
displayUnit String 宝箱 展示单位名称
displayCount String 0.01 展示数值(如 0.01 个宝箱)集齐 100 个合成一个
displayIcon String https://xxx.com/xxx.jpg 展示图片icon
totalCount String 1231231 该类型当前用户拥有总量

请求示例

{"openId":"1231","channel":"dft","count":123,"actionId":"a2b3","strategy":"random","type":"gold"}

响应示例

{
    "bizCode":"SUCCESS",
    "bizMsg":"success",
    "success":true,
    "type":"sprite",
    "count":1,
    "displayUnit":"宝箱",
    "displayCount":"0.01",
    "displayIcon":"https:\/\/xxx.com\/xxx.jpg",
    "totalCount":"1231231"
}

验签示例

{"bizMsg":"Illegal request","bizCode":"sign-check-failure"}

错误码解释

错误码 错误描述 解决方案

API工具

FAQ

返回
顶部