# 推荐页游戏卡
# 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 + "×pan=" + 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) |