24好玩

渠道模式开放接口（嵌入与OEM）

渠道模式面向 OEM/平台型伙伴：用商家 SSO（签名直登工作台）为子账号免密开通创建/管理活动的能力，用玩家签名进入把活动嵌入自有 APP/小程序/公众号（玩家免登录），并可拉取渠道专属活动市场货架。每个渠道有独立 platform_appid 货架与品牌白标。

能力构成

能力 说明
商家 SSO 渠道系统内一键跳转 24好玩工作台（免账号密码）
子账号体系 渠道为下属商户开子账号、管理活动额度
玩家嵌入 活动嵌入渠道自有触点，玩家身份由渠道注入
渠道活动市场 渠道专属模板货架（可按渠道定制上架内容）
白标 渠道品牌标识、独立域名

完整对接文档（含历史细节）见开放文档站 /docs/（embed/auth·channel·sub·game·data 各篇）。

一、商家 SSO（创建者登录）

渠道系统生成签名 URL 跳转平台 /auth 入口：

sign = md5( appid + appsecret + timestamp + uid + name + phone )   ← 固定顺序直接拼接
  • appid/appsecret：渠道凭据（open_auth）；
  • timestamp：秒级时间戳；uid：商户在渠道侧的唯一标识（平台以此建立/匹配子账号）；
  • 验证通过后进入工作台，商户可创建/编辑/发布活动。

二、玩家嵌入（活动进入）

渠道触点（APP/小程序 WebView/公众号）打开签名后的活动进入 URL：

/game_enter/index.html?game_id=...&appid=...&uid=...&timestamp=...&is_from_app=1&token=<sign>
  • 签名为方案 B（固定字段集 ksort 拼值 + 密钥 md5，560 秒时间窗；可附 nickname/headimgurl/phone 注入会员资料），详见第三方CRM对接；
  • 平台按 uid 找到或创建玩家、签发玩家 JWT，随后活动内的抽奖/发奖都归属该会员身份；
  • iframe 嵌入序列：门户先加载签名 enter URL（绑定态）→ 活动壳完成第三方登录绑定 → 通过 postMessage('third_login_callback') 通知门户 → 门户以正式 gameUrl 重载 iframe 进入可玩态；
  • 玩家 JWT 通过 ?jwt= URL 参数携带（iframe 场景下不能依赖 httpOnly Cookie）。

三、渠道活动市场与子账号

接口 用途
/open/gameMarket/cases 渠道活动市场案例列表（当前 300+ 案例）
/open/gameBox 渠道子账号的活动列表
/open/agent/paymentUid、/open/OpenPlatformAjax/* 子账号开通/升级/管理

渠道货架按 platform_appid 隔离：每个渠道看到自己上架的模板卡片与"为你精选"栏目。

渠道数据接口

JWT 鉴权（Bearer，Payload 内为子账号 APPID；构造见高级会员接口）的活动数据拉取族，POST + JSON body。这是API/JWT 版的数据出口——与商家登录工作台看到的数据统计页同源，适合渠道系统按子账号程序化拉数（页面版见活动数据分析）：

接口 入参 返回
POST /open/data/analyse/GetGameData game_id、start_time/end_time（日期）、type（view 查看次数 / viewer 查看人数 / play 参与次数 / player 参与人数 / shareer 分享人数）、scene（可选场景） 按日数组 {date, type, value}
POST /open/data/analyse/GetPlayersInfo game_id、pages、limit 参与玩家明细：昵称/头像/省市、appuid、参与与分享次数、phone、中奖数 gift_count、报名信息等，含 total
POST /open/data/analyse/GetGameRank game_id、pages、limit 分数类活动排行榜：rank/score/times、玩家身份（openid/appuid）与地区
POST /open/data/analyse/GetGiftInfo game_id、pages、limit 获奖清单（兑换码、核销状态/时间、领取状态、收件地址、is_other_gift）+ 奖品配置余量 gift_info.left/total

渠道接口目录（速查）

渠道/子账号管理与活动操作的完整端点目录（细节见开放文档站 embed/channel·sub·game 各篇）：

接口 用途 鉴权
GET /open/gameMarket/cases 渠道活动市场案例列表（按渠道 platform_appid 货架，支持标签/行业/名称筛选） JWT（渠道）
GET /open/gameBox 渠道账户下已发布活动列表 JWT（渠道）
POST /open/agent/paymentUid 渠道下已付费/升级子账号列表 JWT（渠道）
POST /open/OpenPlatformAjax/userInfo 按子账号 uid 查其 appid/appsecret JWT（渠道）
POST /open/OpenPlatformAjax/updateUserInfo 子账号升级（account_type，如 enterprise 年费） JWT（渠道）
POST /open/openDataAjax/gameList 子账号活动列表（状态/标签/玩法类型多值筛选） JWT（子账号）
POST /open/openDataAjax/CollectUserInfo 按时间段拉取活动报名信息 JWT（子账号）
POST /open/games/copyGame 复制活动（返回新 game_id） JWT（子账号）
POST /open/games/delGame 删除活动 JWT（子账号）
PUT /open/games/gameStatus 更新活动状态（publish/outdate/pause） JWT（子账号）
POST /open/games/userPlayTimes 查玩家在活动中指定日期的参与次数 JWT
GET /open/games/gameConfig 获取活动配置信息 JWT
POST /open/games/giftConfig 获取活动奖品配置与剩余量 JWT
POST /game/v2/createUser 玩家进活动前预注册平台用户（走活动域名） token 签名（玩家侧签名族）

联调沙箱

平台提供 TEST 环境模拟门户（platform-emulator）：可按渠道身份生成签名的商家 SSO URL 与玩家进入 URL、模拟子账号与玩家、配套假 CRM 验证发奖回调。访问凭据联系客服开通。

相关页面

第三方CRM对接 · 高级会员接口 · 功能清单

最后核对：2026-07-03