AI体育三个页面与地址
本次交付三个独立页面，各自地址与用途不同，不要互相混用。
| 页面 | 地址 | 用途与读者 |
|---|---|---|
| 落地页 | index.html | 对外营销主页，含开户申请弹窗。读者为商户方商务与决策人 |
| 接入文档 | docs-demo.html | 接入文档示例页：47 个条目的目录结构、条目版式与脱敏写法。落地页导航「接入文档」指向此页；开发用开源文档工具搭正式站时照此版式与脱敏口径产出 |
| 原型说明 | docs-guide.html | 本页：落地页设计说明与接入文档开发说明。落地页导航「原型说明」指向此页，读者为我方设计与开发 |
正式文档站上线后：把落地页导航「接入文档」的地址从示例页换成正式文档站地址即可，示例页保留在包内作为版式参照。正式官网上线时：移除顶栏、抽屉与页尾的「原型说明」入口及本页——本页含验收清单与隐藏规则说明，只随交付包流转，不进正式官网。
设计说明（落地页）
落地页整体设计规范。视觉体系为深色科技风，全站统一一套色板、圆角、按钮、卡片与动效语言，不同段落只在内容形态上区分。
全站视觉规格
色板
| 项 | 取值 | 用途 |
|---|---|---|
| 页面底 | #0a0a0c 外层 #000 | 页面主底，外层黑边框衬出圆角页面感 |
| 卡片底 | #14151a / 白 3.5% 玻璃 | 卡片、面板；玻璃卡带 14px 背景模糊 |
| 次级底 | #191a20 / #0d0e12 | 嵌套面板、演示区、代码区 |
| 描边 | #24262e 常规 / #3a3d48 高亮 | 卡片与控件描边 |
| 正文 | #f5f5f7 | 标题与主文字 |
| 辅助 | #9a9ba3 | 说明句、副文案 |
| 弱化 | #5c5d66 | 角注、占位、次要标签 |
| 主色蓝 | #2b7fff 亮蓝 #6fa8ff | 按钮、链接、选中态、数字高亮 |
| 主色渐变 | 120 度 #2b7fff 至 #5b9dff | 主按钮、头像、圆点 |
| 涨跌色 | 红 #ff4d5e 绿 #16c784 | 赔率涨=红、跌=绿；注单盈利与输赢额=红；受理状态徽章=绿 |
| 主客队色 | 主 #0688f9 客 #ff325b | 赛况数据双色对比条与环图 |
| 榜单金 | #f7b32b | 天梯段位、排名、钱包金额 |
形状与字号
| 项 | 取值 | 用途 |
|---|---|---|
| 页面圆角 | 20px | 整页容器 |
| 卡片圆角 | 12px | 卡片、面板、演示窗 |
| 按钮圆角 | 8px | 按钮、输入框、下拉 |
| 胶囊圆角 | 999px | 顶栏、标签胶囊、页签 |
| 正文 | 15px / 行高 1.7 | 全站正文基准 |
| 主标语 | 30 至 48px 700 | 首屏主标题，按视口缩放 |
| 段标题 | 26 至 32px 700 | 各段大标题 |
| 段前缀 | 12.5px 600 字距 .18em | 段落上方的亮蓝小标签，前置一条 20px 短横线 |
| 段副题 | 15px 辅助色 最大宽 640px | 段标题下方说明句 |
| 内容宽 | 1120px 上限 左右 24px | 全站内容容器 |
| 段间距 | 96px 上下（移动端 72px） | 段落垂直节奏 |
全局元素
| 元素 | 规范 |
|---|---|
| 顶栏 | 悬浮胶囊，宽 1080px 上限，高 54px，距顶 22px；玻璃底 18px 模糊；页面在顶部时底色透明融入首屏视频，滚动后显玻璃底 |
| 主按钮 | 蓝渐变底白字，圆角 8px，蓝色投影；悬停上移 2px 且投影加深 |
| 次按钮 | 透明底加主色蓝描边，圆角 8px；悬停描边转亮蓝加 10% 蓝底 |
| 卡片 | 白 3.5% 玻璃底加淡蓝描边，圆角 12px；悬停整体放大 1.5% 或上移 2px |
| 环境光 | 页面纵向分布 5 团蓝色柔光斑，70px 模糊，缓慢位移与呼吸；叠加细点阵背景与轻微噪点层 |
| 悬浮工具条 | 右下固定：商务联系圆钮（蓝渐变加红点提示）、电话钮、回顶部钮（滚动超一屏出现） |
| 加载页 | 进入页面时全屏深底，居中品牌标志加主标语加蓝色进度条，最短 1.15 秒后淡出 |
页面结构九段
落地页自上而下九段，每段职责与视觉形态如下。段落顺序按商户决策链排布：先看产品真实样子，再看玩家留存能力，最后看接入与风控。
| 序 | 段 | 主标题 | 形态与内容 |
|---|---|---|---|
| 1 | 首屏 | 看球、聊球、下注，一个屏幕全搞定 | 背景为真实球场视频（带海报兜底、切后台暂停、减动效时不播）；上下渐隐遮罩压暗；居中一行主标语打字机逐字出现；下方六格记分牌式数字条；再下双按钮；底部「更多」下指箭头 |
| 2 | 产品实况 | 打开就有得玩 | 产品首页真实界面嵌入窗（窗口栏三点加标签），窗上叠六个序号标记框；上方六个导览页签轮播联动标记与气泡说明；桌面显电脑端界面，移动端切手机端界面 |
| 3 | 沉浸观赛 | 一场比赛，全在一屏 | 比赛详情真实界面嵌入窗加五个标记框（视频直播、滚球盘口、聊天室、赛况数据、比分中心）；视频区叠真实循环视频；数据步骤弹出四页签详解悬浮卡；比分中心步切换为比分中心整页界面；移动端五层界面按页签切换（直播频道 / 盘口 / 聊天室 / 数据 / 比分中心） |
| 4 | 特优赔率 | 赔率给得更高，离场随时可走 | 标签行加两张演示卡：加赔卡（原赔划线加加赔价发光跳动）与提前结算卡（报价每 2.4 秒轻微变价） |
| 5 | 玩家社区 | 玩家在这里有身份、有段位、有粉丝 | 三卡横排：热门跟投、天梯段位（币种页签加排名行）、大神资料（头像关注加动态注单流加走势页签） |
| 6 | 核心能力 | 王牌之下，是稳的底座 | 左右结构展示台：左列十条能力按场景分四组、可滚动带渐隐与「更多」提示；右侧同位切换面板；4 秒自动轮播带进度条，悬停暂停；下方五条能力跑马灯 |
| 7 | 安全风控 | 稳，是这门生意的底线 | 六张图标卡两行三列：防护、风控引擎、限额管控、交易团队、透明对账、资产回传 |
| 8 | 快速接入 | 一表开户，最快 1 日上线 | 标签行加申请卡（左四步时间线、右申请表预览下半模糊锁定加开户按钮）；下方规格表（悬停展开全部规格）；再下品牌合作墙八枚标志 |
| 9 | 常见问题 | 合作前，先答清楚 | 六张问答卡两列；下方收尾双按钮；页尾四栏（品牌、产品、接入、联系）加版权与合规声明 |
段落节奏：奇数段以真实产品界面为主视觉，偶数段以卡片与数据为主视觉，避免连续多屏同形态导致翻页疲劳。
全站动效
动效分四类：入场、常驻、联动、反馈。全站统一时长与曲线，减动效偏好开启时全部短路。
入场类
| 场景 | 动效 | 时长 |
|---|---|---|
| 加载页 | 品牌标志与进度条居中；资源就绪后整屏淡出并移除 | 最短 1.15 秒，2.6 秒兜底 |
| 元素滚动入场 | 进入视野的区块由下方 16px 淡入上移，同屏多个元素按 120ms 交错 | 600ms 缓出 |
| 段标题逐字 | 标题拆字，进入视野后逐字淡入上移，每字延迟 32ms | 单字 450ms |
| 主标语打字机 | 首屏主标语逐字输出，光标持续闪烁 | 每字 62ms，延迟 1.35 秒启动 |
| 数字条翻牌 | 六个数字进入视野后从 0 滚动到目标值，千分位与加号保留 | 950ms 缓出 |
常驻类
| 场景 | 动效 | 节奏 |
|---|---|---|
| 环境光 | 五团柔光缓慢位移与缩放呼吸 | 13 至 19 秒往复 |
| 首屏视频 | 循环播放、静音、切后台自动暂停 | 循环 |
| 赔率跳动 | 随机选取赔率单元三步滚动到新值，涨红跌绿着色（涨 #ff4d5e、跌 #16c784）1.1 秒后复位；波动锚定初始值上下 0.06 内，不漂移 | 每 1.2 秒一次 |
| 提前结算报价 | 报价数值小幅变动 | 每 2.4 秒 |
| 跑马灯 | 能力词条无缝横向滚动，两端渐隐遮罩，悬停暂停 | 30 秒一圈 |
| 展示台轮播 | 左列能力项依次点亮，右侧面板同位切换，当前项底部进度条走满即切；悬停暂停 | 每项 4 秒 |
| 导览轮播 | 产品实况六步（手机端五步）与沉浸观赛五步各自轮播，标记框呼吸高亮加气泡说明 | 常规 4.2 秒，玩法下拉步 13.6 秒（四组玩法各 3.4 秒轮完再切步） |
| 直播标识 | 红色直播徽章圆点持续闪烁 | 1.4 秒 |
联动类
| 场景 | 动效 |
|---|---|
| 导览页签与标记 | 点页签或点序号，对应标记框蓝色呼吸高亮，其余序号变暗至 35%，气泡说明在框内或框外弹出 |
| 导览与界面滚动 | 切到某步时嵌入界面自动滚动到对应功能区（如排行榜步右栏下滑） |
| 玩法下拉演示 | 轮播到玩法下拉步时，界面内四组玩法依次展开，面板滑出且下方卡片被推开；切走即停并收起 |
| 导航与段落 | 滚动到某段时顶栏对应导航项高亮 |
| 语言演示器 | 点选语言，右侧演示面板文案即时切换为该语言 |
| 分端切换 | 视口宽度跨 640px 时，嵌入界面在电脑端与手机端之间切换，试玩链接同步换端 |
反馈类
| 场景 | 动效 | 时长 |
|---|---|---|
| 按钮悬停 | 主按钮上移 2px 加投影加深；次按钮描边转亮加 10% 底 | 200ms |
| 卡片悬停 | 放大 1.5% 或上移 2px，描边转亮 | 250 至 350ms |
| 页签悬停与选中 | 文字转亮，选中态加蓝底与蓝字加粗 | 250ms |
| 规格表展开 | 悬停时由 158px 展开至全高，底部渐隐提示消失 | 700ms 缓出 |
| 下指箭头 | 双层箭头错峰上下浮动 | 1.6 秒往复 |
| 弹窗与抽屉 | 抽屉遮罩渐显 300ms、抽屉右滑 380ms；开户弹窗遮罩即时呈现加背景模糊，无过渡 | 即时 / 300 至 380ms |
减动效偏好：系统开启减少动态效果时，入场类与常驻类全部短路（动画时长归零、首屏视频不播），联动与反馈类保留即时切换，功能完整可用。
全站移动端
| 断点 | 处理 |
|---|---|
| 1020px 以下 | 顶栏导航收起（仅留品牌与按钮）；左右分栏段落改单列；展示台左列由纵向改横向滚动；数字条改三列 |
| 640px 以下 | 顶栏收窄，出现汉堡按钮与右侧抽屉；主标语允许折行并放大到 29 至 38px；双按钮全宽竖排；数字条改两列；卡片玻璃模糊关闭改实底（省性能）；段间距降至 72px |
| 嵌入界面 | 桌面显电脑端界面，640px 以下切手机端界面，按容器宽等比缩放 |
| 导览步骤 | 移动端隐藏「最热投注项」步（手机端产品无此模块）；「排行榜」步在手机端切换展示天梯赛季榜界面；其余步骤两端同名同序，各端展示各自界面快照 |
| 悬浮工具条 | 右下位置内收，圆钮由 48px 缩至 44px |
| 横向溢出 | 全站任何宽度下页面本体不出现横向滚动条，宽表格与宽演示区在自身容器内滚动 |
本轮改动范围
上述为落地页整体规范。近两轮改动：一是开户申请弹窗与开户入口，二是产品实况与沉浸观赛两段按新版试玩环境整体更新。
| 项 | 处理 |
|---|---|
| 新增 | 开户申请弹窗一个（页面内弹出，不做独立页面） |
| 改文案 | 顶栏按钮改「立即开户」；快速接入段申请卡主按钮改「开户申请」；接入流程第二步加「开户申请」入口；建联类按钮统一「联系商务」；常见问题收尾改「开户申请」主按钮加「立即试玩」副按钮 |
| 新增入口 | 顶栏导航与移动端抽屉新增「接入文档」「原型说明」两项；页尾联系我们栏新增「接入文档」「原型说明」「商户开户」三项；抽屉另有「商户开户」项 |
| 界面快照更新 | 产品实况与沉浸观赛两段的电脑端与手机端界面快照全部换为新版试玩环境（深色新皮肤）；导览步骤两端对齐：产品实况电脑端六步（手机端隐藏最热投注项）、沉浸观赛两端统一五步（含比分中心）；两段步骤说明文案按产品实际界面核准 |
| 移除 | 右下商务圆钮旁的主动消息气泡与提示音整体移除（圆钮与红点提示保留） |
| 不动 | 首屏、特优赔率、玩家社区、核心能力、安全风控、常见问题各段的内容与视觉 |
| 复用 | 弹窗内所有视觉元素取自落地页现有设计稿：卡片底色、描边、按钮、输入框、胶囊选择、提示文字样式 |
接入文档页不需要设计：文档页由开发用开源文档工具生成，样式跟工具默认主题，只需把品牌标志与主色配上；本说明的设计部分只覆盖落地页改动。
开户入口
七处入口指向同一个弹窗，点击行为完全一致。
关键按钮命名三层定义（全站统一，改文案照此执行）
| 层 | 用词（固定，不再出现别名） | 用在哪 |
|---|---|---|
| 祈使层 | 立即开户 / 立即试玩 / 联系商务 | 实心与描边的行动按钮：顶栏、抽屉底部、首屏双按钮、申请卡副按钮、常见问题收尾副按钮 |
| 动作层 | 开户申请 | 正文里描述动作的按钮与文字链：申请卡主按钮、接入流程第二步、常见问题收尾主按钮、接入文档页顶栏与页尾卡 |
| 名词层 | 商户开户 | 列表条目：页尾联系我们栏、抽屉导航列表项 |
| 位置 | 文案 | 样式 |
|---|---|---|
| 顶栏右侧 | 立即开户 | 复用原「立即试玩」按钮样式：蓝渐变主按钮小号，位置尺寸不变 |
| 快速接入段申请卡 | 开户申请 | 卡内锁定区主按钮，右侧并排「联系商务」次按钮（蓝色描边） |
| 接入流程第二步 | 开户申请 | 说明文字末尾的蓝色文字链，带右尖括号 |
| 常见问题收尾 | 开户申请 | 收尾双按钮主位（实心），右侧并排「立即试玩」次按钮（蓝色描边，跳试玩环境） |
| 页尾联系我们栏 | 商户开户 | 页尾链接样式，与同栏「接入文档」并列 |
| 移动端抽屉导航 | 商户开户 | 抽屉导航项样式，与「接入文档」并列 |
| 移动端抽屉底部 | 立即开户 | 抽屉底部原试玩按钮改为开户，主按钮全宽 |
试玩入口保留：首屏主按钮与常见问题收尾副按钮的「立即试玩」仍跳试玩环境，按视口宽度自动切电脑端与手机端地址；沉浸观赛段文字链同规则。
开户弹窗
| 项 | 规范 |
|---|---|
| 视觉体系 | 沿用落地页深色体系：卡底 #14151a、描边 #3a3d48、主按钮蓝渐变 #2b7fff 至 #5b9dff、错误红 #ff4d5e、辅助文字 #9a9ba3、弱化文字 #5c5d66 |
| 遮罩 | 深色半透明 #04060a 62% 加 6px 背景模糊，与落地页移动端抽屉遮罩同款 |
| 尺寸 | 宽 620px 上限，最高 88vh；移动端宽度减 40px 边距、最高 92vh |
| 圆角与阴影 | 圆角 14px；阴影 0 30px 80px 深色 60%，与落地页卡片阴影同族 |
| 滚动 | 内容超高时弹窗内部滚动，滚动条细窄浅色；打开期间页面本体锁定不滚 |
| 头部 | 居中标题「商户开户申请」18px 加粗；下方一行 12px 弱化文字说明审核时效；右上角 32px 方形关闭按钮（描边加叉图标） |
| 底部 | 主按钮「提交申请」大号左对齐，右侧 11.5px 弱化文字说明信息用途 |
| 关闭方式 | 右上关闭按钮、点遮罩空白区；成功态保留关闭按钮 |
弹窗结构示意
┌──────────────────────────────────────────┐ ×
│ 商户开户申请 │
│ 提交后 1 个工作日内建联核对，审核通过开户 │
│ │
│ * 企业类型 [企业] [集团] │
│ * 企业名称 [ 请输入名称 ] │
│ * 账号 [ 请输入账号 ] │
│ * 邮箱 [ 请输入邮箱 ] │
│ * 企业Logo [ 上传图片 ] 未选择 │
│ * 接入币种 [ 请选择 ▾] │
│ * 游戏品牌 [旗舰厅] [亚洲厅] [欧洲厅] │
│ * 钱包类型 [转帐钱包] [单一钱包] │
│ * 接入语种 [简体] [简体中文] [英文] … │
│ 申请越南语、泰语不提供直播服务 │
│ * 默认语种 [ 请选择 ▾] │
│ * 聊天频道 [世界频道] [商户频道] │
│ * 图形验证 [ ] [图形] 换一张 │
│ │
│ [ 提交申请 ] 提交信息仅用于开户审核 │
└──────────────────────────────────────────┘
620px 上限
字段与控件
字段名、顺序、必填与商户后台添加商户弹窗一致。控件只用三种，同一字段两边用同类控件。
| 控件 | 用在哪些字段 | 样式 |
|---|---|---|
| 文本框 | 企业名称、账号、邮箱 | 底色白 4%、1px 描边、圆角 8px、内边距 10-13px、字号 13.5px；占位文字用弱化色 |
| 胶囊选择 | 企业类型、游戏品牌、钱包类型、接入语种、聊天频道 | 1px 描边圆角 7px、内边距 5-13px；选中态蓝底 14% 加蓝色描边 50% 加蓝字加粗。单选与多选同款式，靠点击行为区分 |
| 下拉框 | 接入币种、默认语种 | 与文本框同底同描边，右侧自绘下箭头（灰色 2px 线性） |
| 上传 | 企业Logo | 虚线描边按钮加上传图标；右侧显示已选文件名或「未选择」 |
| 图形验证 | 图形验证 | 输入框与图形并排；图形 108×40 深底圆角，点击图形或点「换一张」重绘 |
标签与说明
| 元素 | 规范 |
|---|---|
| 字段名 | 13px 辅助色，必填字段名前红色星号；单行不换行 |
| 字段内说明 | 跟在字段名后 11.5px 弱化色，如企业Logo 后「图片大小 50*50px，小于 1M」 |
| 字段下提示 | 11.5px 弱化色独立一行，如接入语种下「申请越南语、泰语不提供直播服务」 |
| 排布 | 单列纵向排布，字段间距 13px；不做左右两栏，避免与商户后台顺序错位 |
校验与成功态
| 状态 | 表现 |
|---|---|
| 默认 | 输入框灰色描边，胶囊未选中为灰字灰边 |
| 聚焦 | 输入框描边转主色蓝，无外发光 |
| 校验失败 | 输入框描边转红；胶囊组描边转红 40%；下方出现 12px 红字提示；提示文字与商户后台一致（请输入企业名称 / 请输入账号 / 请输入邮箱地址 / 请选语种） |
| 失败定位 | 提交时页面平滑滚动到第一个出错字段并居中，不抖动不闪烁 |
| 纠错清除 | 用户重新输入或重新选择时，该字段红色态立即清除 |
| 成功态 | 表单区整体替换为成功卡：绿色对勾圆形图标、标题「申请已提交」、一行后续说明（1 个工作日内建联核对；审核通过开户，下发测试环境与商户账号）、查看接入文档与关闭两个按钮 |
| 成功态不展示 | 不展示申请编号（编号由后台生成，页面不造号） |
动效
动效只服务三件事：点了有反应、内容变了、错在哪。不做入场花式动画。
| 场景 | 动效 | 时长与曲线 |
|---|---|---|
| 弹窗打开 | 遮罩即时呈现加背景 6px 模糊，无渐显过渡；弹窗本体直接呈现，不做缩放或翻转 | 即时 |
| 弹窗关闭 | 遮罩即时消失，页面滚动解锁 | 即时 |
| 按钮悬停 | 主按钮上移 2px 加阴影加深；次按钮描边转亮蓝加 10% 蓝底 | 200ms 缓出 |
| 输入聚焦 | 边框灰转蓝 | 200ms |
| 胶囊点击 | 切换选中态：蓝底加蓝字加加粗，无缩放弹跳 | 200ms |
| 胶囊悬停 | 描边转亮、文字转白，无位移 | 200ms |
| 下拉展开 | 沿用浏览器原生下拉，不自绘浮层 | 原生 |
| 校验失败 | 描边转红加红字提示直接出现；页面平滑滚动到首个出错字段 | 提示即时，滚动平滑 |
| 语种联动 | 勾选或取消接入语种时，默认语种下拉选项即时重建，已选值仍在则保留 | 即时 |
| 验证码刷新 | 点击图形或点换一张立即重绘 | 即时 |
| 提交成功 | 表单区整体替换为成功卡，弹窗内容区滚回顶部 | 即时切换 |
| 页面其他动效 | 落地页原有动效（滚动淡入、快照导览轮播、赔率跳动、跑马灯）全部不动 | 保持原状 |
减动效偏好：系统开启减少动态效果时，弹窗过渡与平滑滚动短路为即时切换，功能不受影响。
移动端
| 项 | 处理 |
|---|---|
| 弹窗尺寸 | 左右各留 20px 边距，最高 92vh，内部滚动 |
| 内边距 | 由 24-26px 降至 20-16px |
| 图形验证行 | 允许换行，输入框占满一行、图形与换一张在第二行 |
| 提交行 | 主按钮与说明文字上下排列，不并挤 |
| 胶囊组 | 自动换行，行间距 7px；触控目标最小高度 34px |
| 入口 | 顶栏「立即开户」保留；抽屉内新增「商户开户」项，抽屉底部按钮改「立即开户」 |
开发说明（接入文档）
接入文档页用开源文档工具搭建，不需要设计稿。本说明界定：文档站怎么起、哪些内容可以出外网、哪些必须隐藏。
文档站落地方式
| 项 | 说明 |
|---|---|
| 形态 | 开源文档工具生成的静态站点，与官网同域部署，访问地址 /docs |
| 工具选型 | 开发按团队习惯选，要求满足三点：左侧目录树、条目内锚点、目录内搜索 |
| 品牌 | 只需把品牌标志与主色 #2b7fff 配进工具主题；其余样式跟工具默认，不另做视觉稿 |
| 内容形式 | 按工具支持的文档格式逐条撰写，一个条目一节，标题即条目名 |
| 版式参照 | 照上传包内 docs-demo.html 的条目版式与脱敏写法产出：条目名加类型标签、一句说明、地址占位行、参数表加省略行、脱敏响应示例 |
| 不做登录 | 公开层不做账号体系；受限内容不放进公开层，而不是靠登录遮挡 |
| 入口 | 官网顶栏导航、页尾联系我们栏、移动端抽屉三处「接入文档」链接现指向包内示例页 docs-demo.html；开户弹窗成功态的「查看接入文档」按钮同样指向示例页。正式文档站上线后四处统一换成 /docs |
搬运范围
内容来自商户后台现有对接文档。目录与条目命名保持一致，商户两边对照不会错位；具体内容按下表取舍。
| 商户后台文档区块 | 公开层处理 |
|---|---|
| 接入指南 | 搬：接入流程与准备事项 |
| 条目目录与条目名 | 搬：顺序与命名不改 |
| 条目描述句 | 搬：保留原意，去掉内部口吻 |
| 请求参数说明表 | 部分搬：保留参数名、类型、必填、说明；备注列中的实现细节与取值上限不搬 |
| 返回参数说明表 | 部分搬：同上规则 |
| 请求与响应报文示例 | 改写后搬：结构保留，值全部脱敏 |
| 请求地址与路径 | 不搬：替换占位 |
| 加密方式与示例代码 | 不搬 |
| 状态码与错误码全表 | 部分搬：只留通用几条 |
| 计费说明 | 不搬 |
| 联调测试工具 | 不搬 |
| 导出完整文档 | 不做 |
条目分三类写
| 类型 | 组成 | 典型条目 |
|---|---|---|
| 调用类 | 说明句、地址占位、参数表、脱敏响应示例 | 登录、存取款、余额、投注、注单类 |
| 说明类 | 说明文字，不带参数表 | 各端接入方式、单一钱包接入说明、接入流程 |
| 受限类 | 一句话加「开户后商户后台可见」 | 商户登录方式、玩法与赛事字典 |
隐藏规则四档
唯一判据：公开层让商户看懂有哪些能力、要传哪些字段、怎么开始。凡是能让人直接拼出一个打得通的请求的内容，包括地址、密钥、加密方式、真值示例，一律不出外网，开户后在商户后台提供。
A 档整段不出外网
| 内容 | 公开层处理 | 原因 |
|---|---|---|
| 联调地址、正式地址 | 替换为占位，写「开户后按商户下发」 | 真实地址是被刷与被攻击的入口 |
| 请求路径 | 不出现，路径前缀与版本段也不出 | 路径可推测服务划分与版本分布，便于批量探测 |
| 应用密钥、实际密钥、加密盐 | 一个字符不出 | 拿到即可伪造请求 |
| 加密方式与各语言实现代码 | 整段不搬。公开层只写「请求参数需加密，加密方式与密钥开户后提供」 | 实现细节配上密钥等于完整攻击工具 |
| 密钥派生过程 | 不出现，含摘要次数、截取长度、编码方式 | 等同泄露加密方式 |
| 玩法代码全量清单 | 整段不搬，写「玩法字典开户后商户后台可见」 | 盘口能力全集属核心资产，竞品照抄即摸清供给范围 |
| 计费说明整栏 | 整栏不搬，含有效投注额计算口径 | 商务条款，公开被比价压价 |
| 联调测试工具 | 公开层不做 | 调试入口应在授权环境内使用 |
| 导出完整文档功能 | 公开层不做 | 公开层是节选，不提供整份带走 |
B 档字段名保留、真值必须隐藏
字段名给出来，商户开发才知道要传什么；真值一律不给。这是能看懂与能打通之间的分界线。
| 字段性质 | 公开层写法 |
|---|---|
| 商户标识、应用标识 | 字段名保留，值写 xxxxxxxx 占位 |
| 加密后的报文字段 | 值写「加密后的密文」，不放真实密文串（长串本身可被用于分析） |
| 登录凭证、玩家唯一标识 | 值统一打码 |
| 返回的跳转地址类字段 | 写 https://xxxxx，不带任何凭证参数 |
| 客户端服务域名类字段 | 字段名与用途保留，值打码 |
| 登录名、昵称、商户流水号 | 用 demo001 这类明显假值，不用真实测试账号名 |
| 交易流水号、订单号 | 格式示例可留，值用明显假值 |
| 时间戳、系统时间 | 格式示例可留，值用整点假值 |
正确
"商户标识": "xxxxxxxx",
"加密数据": "加密后的密文",
"登录名": "demo001",
"跳转地址": "https://xxxxx"
错误 · 真值与长串不能出现
"商户标识": 真实的三十二位标识串
"加密数据": 真实的加密密文长串
"跳转地址": 真实域名带凭证参数
C 档数值与枚举脱敏
| 内容 | 公开层处理 | 原因 |
|---|---|---|
| 按币种的金额上限数值 | 写「金额上限按币种设定，具体数值开户后提供」 | 具体数值是试探边界的参照 |
| 单笔交易金额区间 | 同上，不给区间端点 | 同上 |
| 金额精度约定 | 可保留，整数位与小数位约定属通用规则 | 通用约定，无利用价值 |
| 钱包币种编号枚举 | 只留业务含义（人民币 / USDT / 泰铢 / 越南盾），不以内部编号为主体呈现；与开户表单的「钱包类型（转帐钱包 / 单一钱包）」是两个概念，勿混 | 业务方看含义，编号属实现细节 |
| 状态码与错误码全表 | 只留 3 至 5 条通用示意（成功、参数错误、余额不足），其余不搬 | 逐条错误码暴露内部处理环节与模块划分，等于内部结构图 |
| 请求频率上限 | 写「按商户分级限频」，不给数字 | 数字是压测与探测的参照值 |
| 风控相关阈值 | 整段不搬 | 防针对性规避 |
| 单次查询时间跨度上限 | 写「单次跨度上限开户后商户后台可见」 | 避免按上限设计批量拉取 |
D 档可完整公开
- 条目名称、所属分组、一句功能说明
- 参数名、类型、必填与否、参数说明（值不给真值，见 B 档）
- 报文格式与字符编码、时间口径与时间格式
- 接入流程文字说明、各端接入方式说明、准备事项
- 基础字段的业务含义（币种名称、语言名称、球种名称）
- 常见问题、商务联系入口、合规声明
拿不准时按三问定档：第一问，这条内容单独看能不能拼出一次请求，能则 A 档。第二问，是不是具体的值或数字，是则 B 档或 C 档。第三问，只是名称与说明，是则 D 档。三问都拿不准就按更严的一档处理。
改写对照
同一条目从商户后台文档搬到公开层的前后对照，照此改写即可。左侧只列结构，不写真实内容。
商户后台文档的结构
条目名 [导出文档]
描述句
请求行：请求方式加真实路径
请求参数：真实标识、真实应用标识、环境、真实密文
待加密参数：登录名、时间戳、币种等
备注：加密方式说明，指向加密方法段
请求参数说明表：参数名 / 类型 / 必填 / 说明 / 备注（含取值上限）
请求示例：含真实标识与真实密文
响应示例：含真实凭证、真实玩家标识、带凭证的跳转地址
返回参数说明表
状态码说明表：业务码全表加通用码全表
公开层改写结果
条目名 所属分组 [服务端调用]
一句功能说明
地址：https://●●●●●●●●●●/●●●●●● 开户后按商户下发
参数表：参数名与类型必填照原文，说明去掉实现细节
表尾两行省略行，表示未列全
响应示例（脱敏）
{ "状态": "成功", "●●●●": "●●●●●●" }
不进入公开层：真实路径、真实标识、密文、加密方式与代码、
取值上限、错误码全表、导出文档按钮
逐项定档
| 原文内容 | 档位 | 改写结果 |
|---|---|---|
| 请求路径 | A | 整体替换为打码占位 |
| 加密方式说明与代码 | A | 整段删，改一句「加密方式开户后提供」 |
| 导出文档按钮 | A | 公开层不做 |
| 商户标识与应用标识真值 | B | 字段名留，值改占位 |
| 密文字段 | B | 值改「加密后的密文」 |
| 凭证与玩家标识真值 | B | 值打码 |
| 带凭证的跳转地址 | B | 域名打码且去掉凭证参数 |
| 备注列取值上限 | C | 删数值，改「开户后提供」 |
| 错误码全表 | C | 留 3 至 5 条通用 |
| 钱包币种编号枚举 | C | 只留业务含义 |
| 参数名与类型必填 | D | 照原文保留 |
| 条目名与描述句 | D | 照原文保留 |
填充原则：宁少不错。某条参数说明拿不准是否属于实现细节，只保留参数名与类型，说明留空比写错更安全。拿不准的条目列成清单交回审核，只审例外不审全量。
开户提交去向
| 项 | 说明 |
|---|---|
| 字段一致性 | 官网弹窗字段与商户后台添加商户弹窗一致、顺序一致、必填一致、错误提示文字一致。审核通过后可直接带入后台创建商户，不二次录入 |
| 官网侧新增 | 图形验证码用于公开表单防刷；服务端另加同来源提交频率限制 |
| 提交去向 | 进商户后台开户申请待审核列表，人工审核通过后创建商户；不存在提交即开户 |
| 后台待审核列表 | 需新增：列表展示申请时间、企业类型、企业名称、账号、邮箱、接入币种、语种、钱包类型、游戏品牌、聊天频道；操作为通过与驳回；通过后进入添加商户流程并带入字段 |
| 受理回复 | 提交后向填写邮箱发送受理回复，模版由运营维护，含企业名称、申请账号、审核时效、通过后下发内容 |
| 成功态 | 页面只展示后续步骤，不展示申请编号，编号由后台生成 |
| 不在官网收集 | 测试账号密码、测试域名、客户端下载地址、正式环境放行清单，开户完成后由商务收取 |
| 商务评估信息 | 会员地区、每日预估活跃人数、每日预估投注额度、接入应用程序，开户通过后由商务补收 |
验收清单
接入文档页
- 目录分组与条目名称与商户后台文档一致，无遗漏、无自造条目
- 每个调用类条目具备说明句、地址占位、参数表、脱敏响应示例
- 受限类条目标注开户后可见
- 目录树、条目锚点、目录搜索三项可用
隐藏项检索
- 全站检索无真实域名与地址
- 全站检索无请求路径片段
- 全站检索无密钥、盐、密文长串
- 全站检索无加密实现代码与密钥派生步骤
- 全站检索无玩法代码清单
- 全站检索无费率、限额、频率、金额上限数字
- 示例中的标识、凭证、账号均为打码或明显假值
- 错误码不超过 5 条且均为通用含义
落地页开户弹窗
- 七处入口均可打开弹窗，打开时页面本体不滚动
- 空表单提交时全部必填字段标红并给出提示，页面滚到第一个出错字段
- 字段名、顺序、必填、提示文字与商户后台一致
- 默认语种下拉与已勾选语种联动正确
- 图形验证码可刷新，错误时提示正确
- 填全提交后进入成功态，展示后续步骤，可关闭
- 1440 与 390 两种宽度下弹窗与页面均无横向滚动条
- 落地页各段动效与两段导览联动（轮播、标记高亮、界面滚动）均正常