AI体育 AI体育接入文档与开户 · 说明
返回官网

四个页面与地址

本次交付四个独立页面,各自地址与用途不同,不要互相混用。

页面地址用途与读者
落地页index.html对外营销主页,含开户申请弹窗。读者为商户方商务与决策人
接入文档docs-demo.html接入文档示例页:47 个条目的目录结构、条目版式与脱敏写法。落地页导航「接入文档」指向此页;开发用开源文档工具搭正式站时照此版式与脱敏口径产出
原型说明docs-guide.html本页:落地页设计说明与接入文档开发说明。落地页导航「原型说明」指向此页,读者为我方设计与开发
申请列表原型admin-apply.html运营后台「申请列表」页原型(平台管理系统、商户接入管理组):官网开户申请的落库去向,筛选、企业类型切换、宽表、通过与驳回、查看详情全部可操作。读者为我方开发与运营
定位:包内四页均为原型,是 UI 出图与开发实现的需求基准,不作为上线产物;正式落地页、文档站与后台页面以 UI 设计稿为准重新实现。

设计说明(落地页)

落地页整体设计规范。视觉体系为深色科技风,全站统一一套色板、圆角、按钮、卡片与动效语言,不同段落只在内容形态上区分。

全站视觉规格

色板

取值用途
页面底#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 模糊,缓慢位移与呼吸;叠加细点阵背景与轻微噪点层
悬浮工具条右下固定:商务联系圆钮(蓝渐变加红点提示)、邮箱钮(地址展示位留空,邮箱确定后填入并换 mailto 跳转)、回顶部钮(滚动超一屏出现)
加载页进入页面时全屏深底,居中品牌标志加主标语加蓝色进度条,最短 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
横向溢出全站任何宽度下页面本体不出现横向滚动条,宽表格与宽演示区在自身容器内滚动

本轮改动范围

上述为落地页整体规范。近两轮改动:一是开户申请弹窗与开户入口,二是产品实况与沉浸观赛两段按新版试玩环境整体更新。

处理
新增开户申请弹窗一个(页面内弹出,不做独立页面)
改文案顶栏按钮改「立即开户」;快速接入段申请卡主按钮改「开户申请」;接入流程第二步加「开户申请」入口;建联类按钮统一「联系商务」;常见问题收尾改「开户申请」主按钮加「立即试玩」副按钮
新增入口顶栏导航与移动端抽屉新增「接入文档」「原型说明」两项;页尾联系我们栏新增「接入文档」「原型说明」「商户开户」三项;抽屉另有「商户开户」项
界面快照更新产品实况与沉浸观赛两段的电脑端与手机端界面快照全部换为新版试玩环境(深色新皮肤);导览步骤两端对齐:产品实况电脑端六步(手机端隐藏最热投注项)、沉浸观赛两端统一五步(含比分中心);两段步骤说明文案按产品实际界面核准
移除右下商务圆钮旁的主动消息气泡与提示音整体移除(圆钮与红点提示保留)
不动首屏、特优赔率、玩家社区、核心能力、安全风控、常见问题各段的内容与视觉
复用弹窗内所有视觉元素取自落地页现有设计稿:卡片底色、描边、按钮、输入框、胶囊选择、提示文字样式
接入文档页由 UI 出图:文档页视觉与落地页同一套设计语言,出图规格见「文档站视觉与出图」模块;开发照 UI 设计稿定制文档工具主题。

开户入口

七处入口指向同一个弹窗,点击行为完全一致。

关键按钮命名三层定义(全站统一,改文案照此执行)

用词(固定,不再出现别名)用在哪
祈使层立即开户 / 立即试玩 / 联系商务实心与描边的行动按钮:顶栏、抽屉底部、首屏双按钮、申请卡副按钮、常见问题收尾副按钮
动作层开户申请正文里描述动作的按钮与文字链:申请卡主按钮、接入流程第二步、常见问题收尾主按钮、接入文档页顶栏与页尾卡
名词层商户开户列表条目:页尾联系我们栏、抽屉导航列表项
位置文案样式
顶栏右侧立即开户复用原「立即试玩」按钮样式:蓝渐变主按钮小号,位置尺寸不变
快速接入段申请卡开户申请卡内锁定区主按钮,右侧并排「联系商务」次按钮(蓝色描边)
接入流程第二步开户申请说明文字末尾的蓝色文字链,带右尖括号
常见问题收尾开户申请收尾双按钮主位(实心),右侧并排「立即试玩」次按钮(蓝色描边,跳试玩环境)
页尾联系我们栏商户开户页尾链接样式,与同栏「接入文档」并列
移动端抽屉导航商户开户抽屉导航项样式,与「接入文档」并列
移动端抽屉底部立即开户抽屉底部原试玩按钮改为开户,主按钮全宽
试玩入口保留:首屏主按钮与常见问题收尾副按钮的「立即试玩」仍跳试玩环境,按视口宽度自动切电脑端与手机端地址;沉浸观赛段文字链同规则。

开户弹窗

规范
视觉体系沿用落地页深色体系:卡底 #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 [ 上传图片 ] 未选择 │ │ * 接入币种 [CNY] [USDT] [THB] … 可多选 │ │ * 游戏品牌 [旗舰厅] [亚洲厅] [欧洲厅] │ │ * 钱包类型 [转帐钱包] [单一钱包] │ │ * 接入语种 [简体] [简体中文] [英文] … │ │ 申请越南语、泰语不提供直播服务 │ │ * 默认语种 [ 请选择 ▾] │ │ * 聊天频道 [世界频道] [商户频道] │ │ 活跃人数 [ 每日预估,选填 ] │ │ 投注额度 [ 每日预估,选填 ] │ │ 人机验证 [√ 已通过 · 无需操作] │ │ 交互挑战 [第三方验证组件 · 示意] │ │ 判定可疑或提交频繁时自动弹出 │ │ │ │ [ 提交申请 ] 提交信息仅用于开户审核 │ └──────────────────────────────────────────┘ 620px 上限

字段与控件

字段名、顺序、必填与商户后台添加商户弹窗一致。控件只用三种,同一字段两边用同类控件。

控件用在哪些字段样式
文本框企业名称、账号、邮箱、联系方式(选填)、活跃人数(选填)、投注额度(选填)底色白 4%、1px 描边、圆角 8px、内边距 10-13px、字号 13.5px;占位文字用弱化色;联系方式为任一即时通讯账号,活跃人数与投注额度为每日预估数字输入——三项选填不带星号不校验
胶囊选择企业类型、接入币种(37 项可多选)、游戏品牌、钱包类型、接入语种、聊天频道1px 描边圆角 7px、内边距 5-13px;选中态蓝底 14% 加蓝色描边 50% 加蓝字加粗。单选与多选同款式,靠点击行为区分
下拉框默认语种与文本框同底同描边,右侧自绘下箭头(灰色 2px 线性)
上传企业Logo虚线描边按钮加上传图标;右侧显示已选文件名或「未选择」
人机验证条人机验证接入第三方验证服务 Cloudflare Turnstile,隐形模式:组件条显示绿色对勾加「已通过人机验证 · 无需操作」,商户零输入;字段名不带星号(自动完成项),下方一行弱化色说明挑战条件
交互挑战(降级)人机验证同为第三方验证服务的能力:组件判定可疑或同来源提交触发限频时,自动弹出轻交互挑战,通过后方可提交——出题、展示与判定全在第三方服务,不自建图形码的生成与校验。原型中的图形码画面仅为挑战态占位示意,正式实现以验证组件实际样式为准。组件加载失败时提交按钮置灰并提示「验证服务暂不可用,稍后重试」

标签与说明

元素规范
字段名13px 辅助色,必填字段名前红色星号;单行不换行
字段内说明跟在字段名后 11.5px 弱化色,如企业Logo 后「图片大小 50*50px,小于 1M」
字段下提示11.5px 弱化色独立一行,如接入语种下「申请越南语、泰语不提供直播服务」
排布单列纵向排布,字段间距 13px;不做左右两栏,避免与商户后台顺序错位

校验与成功态

状态表现
默认输入框灰色描边,胶囊未选中为灰字灰边
聚焦输入框描边转主色蓝,无外发光
校验失败输入框描边转红;胶囊组描边转红 40%;下方出现 12px 红字提示;提示文字与商户后台一致(请输入企业名称 / 请输入账号 / 请输入邮箱地址 / 请选语种)
失败定位提交时页面平滑滚动到第一个出错字段并居中,不抖动不闪烁
纠错清除用户重新输入或重新选择时,该字段红色态立即清除
人机验证挑战正式实现:验证组件判定可疑或同来源提交触发限频时自动弹出交互挑战,通过后方可提交;组件加载失败(10 秒超时)时提交按钮置灰并提示「验证服务暂不可用,稍后重试」——挑战由第三方验证服务提供,不自建。原型示意:挑战态用图形码画面占位常显不带星号,留空不拦、输入内容才校验对错
成功态表单区整体替换为成功卡:绿色对勾圆形图标、标题「申请已提交」、一行后续说明(1 个工作日内建联核对;审核通过开户,下发测试环境与商户账号)、查看接入文档与关闭两个按钮
成功态不展示不展示申请编号(编号由后台生成,页面不造号)

动效

动效只服务三件事:点了有反应、内容变了、错在哪。不做入场花式动画。

场景动效时长与曲线
弹窗打开遮罩即时呈现加背景 6px 模糊,无渐显过渡;弹窗本体直接呈现,不做缩放或翻转即时
弹窗关闭遮罩即时消失,页面滚动解锁即时
按钮悬停主按钮上移 2px 加阴影加深;次按钮描边转亮蓝加 10% 蓝底200ms 缓出
输入聚焦边框灰转蓝200ms
胶囊点击切换选中态:蓝底加蓝字加加粗,无缩放弹跳200ms
胶囊悬停描边转亮、文字转白,无位移200ms
下拉展开沿用浏览器原生下拉,不自绘浮层原生
校验失败描边转红加红字提示直接出现;页面平滑滚动到首个出错字段提示即时,滚动平滑
语种联动勾选或取消接入语种时,默认语种下拉选项即时重建,已选值仍在则保留即时
挑战示意刷新原型示意:点击图形或点换一张立即重绘;正式实现的挑战交互由验证组件自带即时
提交成功表单区整体替换为成功卡,弹窗内容区滚回顶部即时切换
页面其他动效落地页原有动效(滚动淡入、快照导览轮播、赔率跳动、跑马灯)全部不动保持原状
减动效偏好:系统开启减少动态效果时,弹窗过渡与平滑滚动短路为即时切换,功能不受影响。

移动端

处理
弹窗尺寸左右各留 20px 边距,最高 92vh,内部滚动
内边距由 24-26px 降至 20-16px
验证区人机验证条不换行;挑战组件宽度自适应弹窗(原型图形码示意行允许换行,输入框占满一行、图形与换一张在第二行)
提交行主按钮与说明文字上下排列,不并挤
胶囊组自动换行,行间距 7px;触控目标最小高度 34px
入口顶栏「立即开户」保留;抽屉内新增「商户开户」项,抽屉底部按钮改「立即开户」

设计说明(接入文档)

接入文档页视觉由 UI 出图,与落地页同一套设计语言。结构与公开口径以 docs-demo.html 为基准(打码位一个不少),UI 定视觉,开发照稿定制文档工具主题。

文档站视觉与出图

视觉规格(对齐落地页)

规格
体系深色,与落地页同套:页面底 #0a0a0c 加细点阵背景与两团蓝色环境光斑(70px 模糊、固定不滚动)、示例与代码区 #0d0e12;docs-demo 已按此体系呈现,可直接作为视觉参照起点
主色蓝 #2b7fff、亮蓝 #6fa8ff:链接、当前目录项、参数名、类型标签、按钮与落地页同色
文字正文 #f5f5f7、说明 #9a9ba3、弱化 #5c5d66;参数名与示例值用等宽字体,参数名着亮蓝
描边与圆角描边 #24262e、高亮 #3a3d48、卡片描边淡蓝 rgba(148,170,255,.1);卡片 12px、控件 8px,与落地页一致
顶栏56px 固定玻璃底(18px 背景模糊,与落地页顶栏同质感):品牌标志、搜索框、返回官网、「开户申请」主按钮(蓝渐变加投影,悬停上移 2px,与落地页主按钮同款)
目录树左侧 266px 固定:分组标题小字距加尾随横线(与落地页展示台分组同款);条目项悬停亮字加浅底,当前项亮蓝左边线加蓝字,滚动跟随高亮
条目块逐条卡片化:白 2.8% 玻璃底加淡蓝描边加 12px 圆角,悬停描边转亮(与落地页卡片同语言);卡内为条目名、分组角注、类型标签(服务端调用=蓝渐变、说明=灰描边、开户后可见=金色锁标)、一句说明、地址打码行、参数表、脱敏响应示例
参数表表头深底;必填「是」红字「否」弱化;参数名等宽;表尾打码省略行整行弱化
打码语言圆点打码加灰字「开户后商户后台可见」,与落地页申请卡锁定预览同语言;打码是页面语言,不做空白
移动端900px 断点:目录转抽屉(汉堡开合)、单列内容、宽表格容器内横滑

出图清单(UI 交付)

  1. 桌面 1440 文档首页全貌:顶栏、目录树、联调说明加两到三个条目
  2. 条目三态各一张:调用类、说明类、受限类(锁标)
  3. 移动端 390 两张:目录抽屉收起与展开
  4. 组件标注页:类型标签、打码行、参数表、提示条、搜索框
基准关系:docs-demo 管结构与公开口径,本段管视觉规格,UI 设计稿是开发定制文档工具主题的唯一视觉依据。

开发说明(接入文档)

这部分只给业务标准:哪些内容开户前公开、哪些开户后商户后台看、验收看什么。工具选型与撰写方式由开发定;视觉按 UI 设计稿实现,规格见设计说明「文档站视觉与出图」模块。

文档站落地方式

业务要求
形态与官网同域部署,访问地址 /docs;目录、条目锚点、搜索三个能力可用,其余开发自定
目录口径分组与条目命名与商户后台文档一致,顺序不改、不自造条目——商户两边对照不错位
视觉按 UI 设计稿定制工具主题(深色体系对齐落地页,规格见「文档站视觉与出图」模块);包内 docs-demo.html 作结构、公开口径与视觉起点三重基准
不做登录公开层不做账号体系;受限内容不放进公开层,而不是靠登录遮挡
入口官网顶栏导航、页尾联系我们栏、移动端抽屉、开户弹窗成功态四处「接入文档」入口指向文档站 /docs(原型内四处暂互链示例页示意)

开户前后二分标准

开发按这一节执行即可,不需要逐条判断内容敏感度。一句话标准加两张清单,说清哪边放什么。

一句话标准:开户前,商户要看懂「有什么能力、怎么接入」——公开文档站只放这两类内容。开户后,商户在商户后台拿到「怎么调用」的全部细节。落地页本身不放文档内容,只放「接入文档」入口。

开户前 · 公开文档站放什么

条目放法公开层呈现
联调说明(总览)脱敏版报文格式、时间口径两条照实写;地址打码占位;签名与限频只写「开户后商户后台可见」,不写规则与数字
接入流程 10 条
(电脑网页 / 手机网页 / 客户端各版本、Gbet、虚拟体育)
全文说明类条目,接入方式文字全放——商户开户前评估选型就靠这组
单一钱包接入 2 条全文钱包模式说明全放(商户选转帐钱包还是单一钱包的依据);商户回调条目照调用类版式
页面接入全文说明类,全放
调用类约 30 条
(登录、存取款、登出、资金、余额、会员信息、投注注单、报表核对、主播列表、电子注单、活动订单、系统维护)
条目壳只放四样:条目名加分组、一句功能说明、几行通用参数(商户编号 / 玩家账号 / 金额 / 商户流水号 / 时间戳 / 签名,按条目适用挑)、打码省略行加脱敏响应示例。完整参数表不放
受限 2 条
(商户登录方式、基础字段字典)
锁标条目名加一句话加「开户后可见」锁标,正文不放

开户后 · 商户后台专属(公开层一个字不出现)

  • 联调地址、正式地址、请求路径
  • 签名规则、密钥、加密实现与派生过程
  • 完整参数表(全部字段与取值约束)、真实请求与响应示例
  • 状态码与错误码全表
  • 玩法与赛事字典、币种编号对照
  • 金额上限、请求频率、查询跨度等一切数值边界
  • 计费说明、联调测试工具、完整文档导出
为什么这样分:商户开户前的决策问题是「值不值得接、接起来多大工作量」,条目清单加接入方式说明足够回答;参数细节是开户后开发对接阶段才用的,放公开层既没帮助又有泄露面。这样分完,公开层没有任何需要脱敏加工的内容。

拿不准时的判据

日常按上一节二分标准执行。只有出现二分表没覆盖到的新内容时,按下面判据定放不放;怎么打码、怎么造假值,开发自定。

唯一判据:公开层让商户看懂有哪些能力、怎么开始。凡是能让人直接拼出一个打得通的请求的内容——地址与路径、密钥与加密、真值示例,以及限额频率等数值边界、玩法字典、计费条款——一律不出外网,开户后在商户后台提供。
三问定放不放:第一问,这条内容单独看能不能拼出一次请求,能则不放。第二问,是不是具体的值、数字或编号,是则名称可留、值不放。第三问,只是名称加一句说明,是则可放。三问拿不准就不放,列成清单交回审核——只审例外,不审全量。

开户提交去向

说明
字段一致性官网弹窗必填字段与商户后台添加商户弹窗一致、顺序一致、错误提示文字一致;官网另有三个选填字段(联系方式 / 活跃人数 / 投注额度)只落申请单,不进添加商户弹窗。审核通过后可直接带入后台创建商户,不二次录入
官网侧新增人机验证接入第三方验证服务 Cloudflare Turnstile(免费):默认隐形模式商户零输入;判定可疑或同来源提交触发限频时组件自动弹出交互挑战——不自建图形码的生成与校验;组件加载失败(10 秒超时)提交置灰提示稍后重试;服务端校验人机验证通过凭据,另加同来源提交频率限制兜底
提交去向进运营后台「申请列表」;由人工在列表点「开户」以申请信息带入添加商户弹窗完成开户,不存在提交即开户
申请列表(运营后台)平台管理系统商户接入管理组新增「申请列表」页,原型见 admin-apply.html:筛选(企业名称 / 账号 / 邮箱 / 联系方式)加企业类型切换;列表展示申请时间、企业名称、企业类型、账号、邮箱、联系方式、Logo、接入币种(可多个)、游戏品牌、钱包类型、接入语种、默认语种、聊天频道、活跃人数、投注额度、申请状态。申请状态四种:申请中(未处理)、待审核(已录入商户列表)、已通过(商户列表审核通过后同步)、已驳回。操作按状态:申请中行为开户、驳回、查看;待审核与已通过行为「商户列表查看」(跳转商户列表并按商户账号自动搜索定位);已驳回行留查看。「开户」弹出添加商户弹窗自动填入申请信息(选填三项为参考信息不进商户档案),人工核对确认录入商户列表——录入后本页状态变待审核、商户列表审核通过后同步已通过,本页不产生开户结果;「驳回」填写原因,确认后发送驳回说明邮件并标为已驳回。页内附原型说明与三封邮件格式(申请中 / 已通过 / 驳回,标题加内容)。选填三项空值展示为一字线
申请邮件(三封)申请中(官网提交成功时发送)、已通过(商户列表审核通过开户完成时发送)、驳回(确认驳回时发送,原因取驳回弹窗填写内容);模版由运营维护,按标题加内容展示,全文见申请列表原型页内「原型说明」
成功态页面只展示后续步骤,不展示申请编号,编号由后台生成
不在官网收集测试账号密码、测试域名、客户端下载地址、正式环境放行清单,开户完成后由商务收取
商务评估信息会员地区、每日预估活跃人数、每日预估投注额度、接入应用程序,开户通过后由商务补收

验收清单

接入文档页

  1. 目录分组与条目名称与商户后台文档一致,无遗漏、无自造条目
  2. 每个调用类条目具备说明句、地址占位、参数表、脱敏响应示例
  3. 受限类条目标注开户后可见
  4. 目录树、条目锚点、目录搜索三项可用
  5. 视觉与 UI 设计稿一致:深色体系、蓝主色、打码语言与落地页同款

隐藏项检索

  1. 全站检索无真实域名与地址
  2. 全站检索无请求路径片段
  3. 全站检索无密钥、盐、密文长串
  4. 全站检索无加密实现代码与密钥派生步骤
  5. 全站检索无玩法代码清单
  6. 全站检索无费率、限额、频率、金额上限数字
  7. 示例中的标识、凭证、账号均为打码或明显假值
  8. 错误码不超过 5 条且均为通用含义

落地页开户弹窗

  1. 七处入口均可打开弹窗,打开时页面本体不滚动
  2. 空表单提交时全部必填字段标红并给出提示,页面滚到第一个出错字段
  3. 字段名、顺序、必填、提示文字与商户后台一致
  4. 默认语种下拉与已勾选语种联动正确
  5. 人机验证默认自动通过、零输入;交互挑战由第三方验证组件弹出与判定,站内无自建图形码服务;组件加载失败时提交置灰并提示稍后重试
  6. 填全提交后进入成功态,展示后续步骤,可关闭
  7. 1440 与 390 两种宽度下弹窗与页面均无横向滚动条
  8. 落地页各段动效与两段导览联动(轮播、标记高亮、界面滚动)均正常