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

qimen.taobao.hudong.open.detail.query (游戏详情查询)

读取用户的游戏状态,用于淘宝二楼等透出场景展示信息使用。

公共参数

请求参数

名称 类型 是否必须 示例值 更多限制 描述
openId String 必须 1234 用户ID
checkList String 必须 coin,vst 检查类型,逗号分割多个。双方协定

响应参数

名称 类型 示例值 描述
bizCode String SUCCESS 成功返回 SUCCESS 可重试失败返回 FAIL_XXX 不可重试失败返回 ERR_XXX 系统错误原样返回
bizMsg String success 错误信息
success Boolean true 是否成功
data DetailDTO 具体数据内容
  • check
  • CheckDTO
  • 1000
  • 检查的需要提醒的内容;
  • └ amount
  • Number
  • 0
  • 目标当前额度
  • └ maxAmount
  • Number
  • 1000
  • 目标总额度
  • └ type
  • String
  • coin
  • 内容类型用于,如果类型和配置中需要的不匹配,不出现。

请求示例

{"openId":"1234","checkList":"coin,vst"}

响应示例

{
    "bizCode":"SUCCESS",
    "bizMsg":"success",
    "success":true,
    "data":{
        "check":{
            "amount":0,
            "maxAmount":1000,
            "type":"coin"
        }
    }
}

验签示例

{"bizMsg":"Illegal request","success":"不等于true","bizCode":"sign-check-failure"}

错误码解释

错误码 错误描述 解决方案

API工具

FAQ

返回
顶部