文档中心 > API类目 > 淘宝小程序API

qimen.taobao.miniapp.game.task.award.send (小程序游戏化任务奖励发放)

小程序游戏化,游戏内任务完成后,需要触发ISV对应的游戏奖励发放

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
count Number 必须 200 要发放的代币个数
openId String 必须 23456 用户openId
appId Number 必须 3000007654321 C端小程序id
taskListId Number 必须 2567 任务面板id
actionId String 必须 te3434fad 幂等唯一ID
drawChance Number 可选 1 要赠送的抽奖机会次数

响应参数

名称 类型 示例值 描述
result ResultDTO 发放的结果result
  • └ success
  • Boolean
  • true
  • 是否成功
  • └ errCode
  • String
  • FAIL_XXX
  • 错误码,可重试失败返回: FAIL_XXX ;不可重试失败返回: ERR_XXX ;系统错误原样返回
  • └ errMsg
  • String
  • 错误码对应的详细信息
  • 错误码对应的详细信息

请求示例

{"drawChance":1,"openId":"23456","appId":0,"count":200,"actionId":"te3434fad","taskListId":2567}

响应示例

{
    "result":{
        "success":true,
        "errCode":"FAIL_XXX",
        "errMsg":"错误码对应的详细信息"
    }
}

验签示例

{"result":{"success":"false","errCode":"sign-check-failure","errMsg":"Illegal request"}}

错误码解释

错误码 错误描述 解决方案

API工具

FAQ

返回
顶部