|
|
@@ -1,77 +0,0 @@
|
|
|
-# 整站与游戏维护子类-会员前台修改单(PC / H5 / APP,2026-11-10)
|
|
|
-
|
|
|
-## 改动
|
|
|
-
|
|
|
-1. **维护可以细到子类**:除了整站和 9 个大类,后台现在可以单独维护某个三方平台(如电子里的 PG)、某个 F1 彩种(如极速赛车)或某个 F1 体育项(如篮球)。大类没维护时,其他平台 / 彩种 / 体育项照常可进。
|
|
|
-2. **游戏列表直接带维护状态和「是否支持内嵌」**:三方平台和游戏、F1 彩票、F1 体育的列表项都新增 `is_maintaining`、`maintenance`、`embeddable`,前端按列表项处理,不需要自己拼代码或对照编号。
|
|
|
-3. **新增 F1 体育列表接口** `GET /api/index/sportConfig`。
|
|
|
-
|
|
|
-接口都在 `melbet_sport-api`。原有请求头(`Platform`、`Lang`、`Authorization`)和 `11001` / `11002` 的处理方式不变。
|
|
|
-
|
|
|
-## 一、列表项新增字段
|
|
|
-
|
|
|
-| 接口 | 列表项 | 新增字段 |
|
|
|
-|---|---|---|
|
|
|
-| `/api/egame/platforms`、`/api/egame/electronicGames`、`/api/egame/gameCodes` | 三方平台、平台下的游戏 | `is_maintaining`、`maintenance`、`embeddable` |
|
|
|
-| `/api/index/gameConfig`、`/api/index/getLastLottery` | F1 彩种 | `maintenance_scope`、`is_maintaining`、`maintenance`、`embeddable` |
|
|
|
-| `/api/index/sportConfig`(新增) | F1 体育项 | 同上 |
|
|
|
-
|
|
|
-| 字段 | 说明 |
|
|
|
-|---|---|
|
|
|
-| `is_maintaining` | 该项当前是否不可进入(整站、所属大类或它自己在维护,都会是 `true`) |
|
|
|
-| `maintenance` | `null`,或维护详情:`content`(文案)、`ends_at_utc`(预计结束,可能为 `null`)、`category`(大类)、`subcategory`(子类,大类维护时为 `null`)等,结构同 `/api/maintenance/status` |
|
|
|
-| `embeddable` | 布尔值,该项是否支持内嵌打开,后台设置,默认 `true`;和维护无关。三方平台下的游戏沿用所属平台的值 |
|
|
|
-| `maintenance_scope` | 该项的子类代码,如 `self:lottery:pc28`、`self:sport:basketball`,用于和 `/api/maintenance/status` 对应,一般不用展示 |
|
|
|
-
|
|
|
-F1 彩种示例(`gameConfig` 一项):
|
|
|
-
|
|
|
-```json
|
|
|
-{"type": 7, "name": "极速赛车", "game": "jisu", "params": {"type": 1}, "status": 1, "sort": 0, "is_rec": 0,
|
|
|
- "maintenance_scope": "self:lottery:jisu:1", "is_maintaining": true, "embeddable": true,
|
|
|
- "maintenance": {"scope": "game", "category": "self:lottery", "subcategory": "self:lottery:jisu:1",
|
|
|
- "content": "极速赛车维护中,请稍后再试。", "ends_at_utc": "2026-11-10T20:00:00Z", "...": "其余字段同状态接口"}}
|
|
|
-```
|
|
|
-
|
|
|
-## 二、点击列表项的处理
|
|
|
-
|
|
|
-1. `is_maintaining` 为 `true`:**列表照常显示,不要隐藏**,加「维护中」标记;点击时弹出 `maintenance.content`(纯文本,保留换行),不进入游戏。有 `ends_at_utc` 时可显示预计恢复时间,`null` 显示「恢复时间待定」。
|
|
|
-2. 否则按 `embeddable` 打开:
|
|
|
- - `true`:沿用现在的方式,页面内嵌(iframe / 内嵌 WebView)打开;
|
|
|
- - `false`:**不要内嵌**,改为新窗口打开(PC、H5 用 `window.open` 或整页跳转,APP 用外部浏览器或新开 WebView)。
|
|
|
-3. 最终以进入 / 下注接口的返回为准:列表加载后后台才开始的维护,进入时会返回 `11002`,按原有方式提示 `msg`。
|
|
|
-
|
|
|
-`11002` 的 `data` 新增 `subcategory`:单独维护某个平台 / 彩种 / 体育项时为子类代码(如 `third:2:pg`),大类维护时为 `null`;`data.category` 始终是大类代码。前端提示 `msg` 即可,不需要按它区分处理。
|
|
|
-
|
|
|
-## 三、新增 F1 体育列表 `GET /api/index/sportConfig`
|
|
|
-
|
|
|
-免登录,返回后台「F1体育列表」中显示的体育项,排序规则同 `gameConfig`:
|
|
|
-
|
|
|
-```json
|
|
|
-{"code": 1, "data": [
|
|
|
- {"type": 1, "code": "football", "name": "足球", "status": 1, "sort": 0,
|
|
|
- "maintenance_scope": "self:sport:football", "is_maintaining": false, "maintenance": null, "embeddable": true},
|
|
|
- {"type": 2, "code": "basketball", "name": "篮球", "status": 1, "sort": 0,
|
|
|
- "maintenance_scope": "self:sport:basketball", "is_maintaining": true, "embeddable": true,
|
|
|
- "maintenance": {"scope": "game", "category": "self:sport", "subcategory": "self:sport:basketball", "content": "篮球维护中", "...": "其余字段同状态接口"}}
|
|
|
-]}
|
|
|
-```
|
|
|
-
|
|
|
-- 可用于 F1 体育入口的体育分类导航,点击处理同第二节。
|
|
|
-- 目前只有足球有赛事数据,F1 体育现有的赛事、下注、撤单、足球游戏接口都按「足球」判断维护。其他体育项暂时只用于展示和维护标记。
|
|
|
-
|
|
|
-## 四、维护状态接口 `GET /api/maintenance/status`
|
|
|
-
|
|
|
-`data.games` 的每个大类新增 `children`:当前单独在维护的子类(只列生效的,没有则为 `[]`)。
|
|
|
-
|
|
|
-```json
|
|
|
-{"category": "third:2", "is_maintaining": false, "maintenance": null,
|
|
|
- "children": [{"category": "third:2:pg", "parent": "third:2", "is_maintaining": true, "maintenance": {"...": "维护详情"}}]}
|
|
|
-```
|
|
|
-
|
|
|
-- 大类入口仍看 `games[].is_maintaining`。只有 PG 维护时电子大类是 `false`,电子入口照常可进。
|
|
|
-- 平台 / 彩种 / 体育项的维护标记优先用第一节列表上的字段;没有列表数据的页面可以用 `children` 判断。
|
|
|
-
|
|
|
-## 不用改的
|
|
|
-
|
|
|
-- 请求头、整站维护页(`11001`)、维护页轮询和倒计时,沿用原有接入。
|
|
|
-- 下注接口参数不变:`/api/game/bet` 的 `pc28` 传 `0`(加拿大28)或 `1`(极速28);`/api/jisuGameOrder/submit` 的 `data[].id` 传单个正整数玩法 ID(传数组等非法值会返回「投注项编号无效」)。
|