小游戏专属

修订记录

文档版本 更新日期 更新内容
1.0.0 2025.03.26 初始化
1.0.1 2025.07.15 新增同步微信游戏圈任务变更信息接口

1. 获取抖音用户已就绪场景列表

1.1 说明

注意：
1、抖音直出要求总接口耗时控制在300毫秒以内，其中平台预留100毫秒，游戏接口需确保耗时控制在200毫秒以内。
2、建议初始配置为100 QPS，后续可根据抖音直出的实际访问情况进行动态调整。如需更高 QPS，需提前与平台确认后再进行调整。
file

1.2 请求方式
  • GET
1.3 请求参数
参数名 类型 长度 说明 是否必传
open_id string 32 聚合OpenID 是
1.4 返回参数
字段名 类型 说明
data.list array 用户就绪场景列表
data.list.scene int 就绪的场景值：​1： 离线收益场景​2： 体力恢复场景​3： 重要事件掉落​
data.list.content_ids array 就绪场景对应自定义文案ID列表，例如：["CONTENT27648287"]
data.list.extra string 开发者可为每个场景携带额外的信息，长度需要<100字符
  • 响应示例：
{
    "status":1,
    "msg":"success",
    "data":{
        "list":[
          {
            "scene": 1,
            "content_ids": ["CONTENT27648287"],
            "extra": ""
         },
          {
            "scene": 2,
            "content_ids": ["CONTENT27648031"],
            "extra": ""
          }
        ]
    }
}

2. 同步微信游戏圈任务变更信息

2.1 说明
2.2 请求方式
  • GET
2.3 请求参数
参数名 类型 长度 说明 是否必传
channel_id int 11 渠道ID 是
open_id string 32 聚合OpenID 是
task_list string,json - 任务列表 是

task_list 参数说明：

参数名 类型 长度 说明 是否必传
id int 11 任务ID 是
status int 3 任务状态（1-未完成 2-已完成 3-已领取） 是
1.4 返回参数
  • 响应示例：
{
    "status":1,
    "msg":"success",
    "data":{}
}
文章目录