文档修订记录

版本	更新日期	更新内容
3.1.1	2025.05.19	提供批量推送抖音小游戏的订阅模板消息接口

1. 批量推送抖音小游戏的订阅模板消息接口

1.1 说明

目前支持了将抖音平台的订阅模板消息内容批量推送到用户，具体接入找平台协助处理。

1.2 Api地址

地址: https://api-combine.feiyu.com/v1/douyinMiniGame/template/batchPush

1.3 请求方式

POST

1.4 请求头

"Content-type":"application/json"

1.5 请求参数

请求示例：

{
    "app_id":"33328",
    "message_list": [
        {
            "open_id":"37216e162b257722bd2257094431508f",
            "template_id":"MSG1809092137217501526560818743552",
            "data":{
                "礼包奖励":"111",
                "通知日期":"111",
                "通知时间": "111"
            }
        }
    ]
}

参数名	必选	类型	说明
app_id	是	string	应用ID
message_list	是	list<Object>	消息列表（一批最多支持推送1000条消息，超过则取前1000个）
message_list.open_id	是	string	用户的聚合openID（不是抖音openID）
message_list.template_id	是	string	抖音模板ID（在“抖音开放平台-运营能力-订阅消息”中查看）
message_list.data	是	Object	模板内容，格式形如 {"礼包奖励":"111","通知日期":"111","通知时间":"111"}
timestamp	是	string	10位时间戳
sign	是	string	签名值
sign_type	是	string	签名类型(默认：md5)
sign_nonce	是	string	签名随机数(随机数字+字符串共8位)
sign_version	是	string	签名版本，1.1

参考文档：https://developer.open-douyin.com/docs/resource/zh-CN/mini-game/develop/server/notify

1.6 返回参数

返回实例：

{
    "trace_id": "66be5dedc787190804a0b0202ae39758",
    "status": 0,
    "message": "OK",
    "data": {

    }
}

通用参数

参数名	类型	说明
trace_id	string	请求唯一ID
status	int	状态码, 0代表成功，非0状态码可参考如下错误码表格确认信息
message	string	返回结果描述

错误码

status	说明
400	错误请求，参数有误
500	未知的服务内部错误（无法拿到明确message，可联系平台研发排查问题）
4000	业务内部错误（能拿到明确message）

数据参数

暂无

2 签名规则

2.1 MD5签名

2.1.1、获取基础接入参数

在【对接中心->渠道打包->配置参数】，：App ID（请求参数app_id）和App Secret（签名密钥）。

2.1.2、签名文档

参考：鉴权指南md5 - v1.1