# 推荐页游戏卡

# 1、接口地址

  • 生产环境:https://xxxxxxx/api/dyminigame/pushfeedcard

域名请联系发行获取(安全模块域名)

# 2、使用场景

WARNING

  • 前提:抖音小游戏用户才能调用接口:
  • 场景:开启消息订阅功能,并在抖音开发者平台配置了消息订阅模版。
  • 逻辑:确定规则-后,抖音开发者平台配置模板,对核心用户召回或经营,游戏服务器调用本接口,本接口通知抖音触达用户。
  • 参考抖音推荐场景游戏卡 (opens new window)

# 3、接口说明

DANGER

  • 非必接

# 4、请求方式

  • 方式:POST

  • 接入方式: 直接接入

    请求参数: headers头 Body raw(JSON)

参数类型 字段名 值类型 必填 说明
Body appId int 产品ID
Body timespan long 当前时间戳,秒,前后2小时有效
Body sign long 接口加密签名md5("accountId=" + accountId + "&appId=" + appId + "&openId=" + openId + "&tplId=" + tplId + "&timespan=" + timespan + appkey)
Body accountId long SDK用户登录后的账号ID
Body mainChannel int sdk配置的主渠道ID
Body secondChannel int sdk配置的次渠道ID
Body openIds string[] 抖音小游戏的用户open_id集合,单次最多推送给100名用户
Body aId string 抖音小游戏的需要下发的宿主端ID,抖音传1,抖音极速版传2
Body cardId string 抖音小游戏的需要推送的卡片ID
Body data json 抖音小游戏的用于填充奖励信息的数据,{"data":{"reward_index":"1", // 需要下发的奖励内容Index "reward_count":"[10,20]" // 奖励内容对应的奖励个数}},参考抖音 (opens new window)

# 5、接口响应说明

  • 请求示例
{"appId":1363299672,"sign":"1236c84d2332bb1d9716585f2803864e","timespan":1742441232,"mainChannel":100774,"secondChannel":100775,"accountId":2111124236,"openIds":["_00071Rose4vzWaGGNvgezdFEhksQIizpFRY"],"aId":1,"cardId":2,"data":{"reward_index":"1","reward_count":"[10,20]"}}
  • 验证不通过响应结果JSON格式

    {
    "resultCode": 14005,
    "datum": {
        "err_no": 28001038,
        "err_tips": "msg_id不合法"
    },
    "resultInfo": "推送抖音失败",
    "rid": "sidysubscribenotifi.9ce86a75cd4a4bb090da7ffabf78ff7b"
    }
    
    
  • 返回说明:

参数类型 字段名 值类型 说明 备注
result resultCode int 响应值 10000发送消息成功,其它失败
result resultInfo string 提示信息
result rid string response identifies(响应唯一标识)
result datum T 抖音返回消息 内容说明 (opens new window)
Last Updated: 2025/3/25 15:48:44