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

qimen.taobao.miniapp.game.task.award.revert (小程序游戏化任务奖励回退)

小程序游戏化,游戏内任务完成且奖励发放后,如果产生任务逆向,则需要触发ISV对应的游戏奖励回退

公共参数

请求参数

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

响应参数

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

请求示例

{"drawChance":1,"openId":"3453222","appId":0,"count":30,"actionId":"daere342432","taskListId":3025}

响应示例

{
    "result":{
        "success":true,
        "errCode":"FAIL_XXX",
        "errMsg":"具体的错误信息"
    }
}

验签示例

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

错误码解释

错误码 错误描述 解决方案

API工具

FAQ

返回
顶部