@hupu-tech/shaper 0.2.12 → 0.2.13
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/CHANGELOG.md +6 -0
- package/README.md +6 -0
- package/dist/cli.js +2 -2
- package/dist/cloud/client.d.ts +0 -1
- package/dist/cloud/service-build.d.ts +2 -4
- package/dist/index.js +1 -1
- package/dist/project/create.d.ts +9 -3
- package/dist/project/delivery.d.ts +5 -5
- package/dist/runtime.d.ts +2 -1
- package/dist/runtime.js +1 -1
- package/dist/shared-2WDEQ3AQ.js +19 -0
- package/package.json +1 -1
- package/skills/business/SKILL.md +158 -0
- package/skills/business/activity/README.md +14 -0
- package/skills/business/activity/hupu-leaderboard-template/SKILL.md +52 -0
- package/skills/business/activity/hupu-leaderboard-template/example/README.md +20 -0
- package/skills/business/activity/hupu-leaderboard-template/example/cloudfunctions/activity_api/.cloudignore +3 -0
- package/skills/business/activity/hupu-leaderboard-template/example/cloudfunctions/activity_api/index.js +218 -0
- package/skills/business/activity/hupu-leaderboard-template/example/cloudfunctions/activity_api/package.json +15 -0
- package/skills/business/activity/hupu-leaderboard-template/example/cloudfunctions/activity_api/scf_bootstrap +3 -0
- package/skills/business/activity/hupu-leaderboard-template/example/index.html +291 -0
- package/skills/business/activity/hupu-leaderboard-template/example/migrations/20260828210000_create_leaderboard.sql +54 -0
- package/skills/business/activity/hupu-lottery-draw/SKILL.md +50 -0
- package/skills/business/activity/hupu-lottery-draw/example/README.md +21 -0
- package/skills/business/activity/hupu-lottery-draw/example/cloudfunctions/activity_api/.cloudignore +3 -0
- package/skills/business/activity/hupu-lottery-draw/example/cloudfunctions/activity_api/index.js +142 -0
- package/skills/business/activity/hupu-lottery-draw/example/cloudfunctions/activity_api/package.json +9 -0
- package/skills/business/activity/hupu-lottery-draw/example/cloudfunctions/activity_api/scf_bootstrap +3 -0
- package/skills/business/activity/hupu-lottery-draw/example/index.html +178 -0
- package/skills/business/activity/hupu-lottery-draw/example/migrations/20260828220000_create_draw.sql +193 -0
- package/skills/business/activity/hupu-pk-voting/SKILL.md +54 -0
- package/skills/business/activity/hupu-pk-voting/example/README.md +44 -0
- package/skills/business/activity/hupu-pk-voting/example/cloudfunctions/activity_api/.cloudignore +3 -0
- package/skills/business/activity/hupu-pk-voting/example/cloudfunctions/activity_api/index.js +370 -0
- package/skills/business/activity/hupu-pk-voting/example/cloudfunctions/activity_api/package.json +15 -0
- package/skills/business/activity/hupu-pk-voting/example/cloudfunctions/activity_api/scf_bootstrap +2 -0
- package/skills/business/activity/hupu-pk-voting/example/index.html +729 -0
- package/skills/business/activity/hupu-pk-voting/example/migrations/20260828220000_create_pk_vote.sql +168 -0
- package/skills/business/activity/hupu-request-activity-execute-vote-task/SKILL.md +77 -0
- package/skills/business/activity/hupu-request-activity-get-vote-detail/SKILL.md +84 -0
- package/skills/business/activity/hupu-request-activity-get-vote-task-list/SKILL.md +86 -0
- package/skills/business/activity/hupu-request-activity-list-by-biz-keys/SKILL.md +153 -0
- package/skills/business/activity/hupu-request-activity-report-vote-task/SKILL.md +58 -0
- package/skills/business/activity/hupu-request-activity-submit-vote/SKILL.md +58 -0
- package/skills/business/activity/hupu-vote-task/SKILL.md +47 -0
- package/skills/business/community/README.md +13 -0
- package/skills/business/community/hupu-request-bbs-detail/SKILL.md +197 -0
- package/skills/business/community/hupu-request-bbs-get-tag-thread-list/SKILL.md +257 -0
- package/skills/business/community/hupu-request-bbs-get-topic-threads/SKILL.md +159 -0
- package/skills/business/community/hupu-request-bbs-gets-thread-post-list/SKILL.md +124 -0
- package/skills/business/community/hupu-request-bbs-open-post-editor/SKILL.md +75 -0
- package/skills/business/community/hupu-request-bbs-reply-post/SKILL.md +59 -0
- package/skills/business/community/hupu-score-add-score/SKILL.md +57 -0
- package/skills/business/community/hupu-score-get-item-detail/SKILL.md +173 -0
- package/skills/business/community/hupu-score-get-score/SKILL.md +263 -0
- package/skills/business/quality/README.md +7 -0
- package/skills/business/quality/hupu-security-check-audit/SKILL.md +39 -0
- package/skills/business/quality/hupu-wasm-compression/SKILL.md +69 -0
- package/skills/business/quality/hupu-wasm-compression/agents/openai.yaml +4 -0
- package/skills/business/quality/hupu-wasm-compression/tool/checks.mjs +90 -0
- package/skills/business/quality/hupu-wasm-compression/tool/compress-worker.mjs +40 -0
- package/skills/business/quality/hupu-wasm-compression/tool/public/app.js +84 -0
- package/skills/business/quality/hupu-wasm-compression/tool/public/index.html +80 -0
- package/skills/business/quality/hupu-wasm-compression/tool/public/style.css +3 -0
- package/skills/business/quality/hupu-wasm-compression/tool/server.mjs +126 -0
- package/skills/business/quality/hupu-web-security-audit/SKILL.md +45 -0
- package/skills/business/quality/hupu-web-security-audit/agents/openai.yaml +4 -0
- package/skills/business/rewards/README.md +13 -0
- package/skills/business/rewards/hupu-vacoin/SKILL.md +70 -0
- package/skills/business/rewards/hupu-vacoin-consume-coins/SKILL.md +47 -0
- package/skills/business/rewards/hupu-vacoin-get-coin-overview/SKILL.md +52 -0
- package/skills/business/rewards/hupu-vacoin-get-session-coins/SKILL.md +44 -0
- package/skills/business/rewards/hupu-vacoin-reset-session-id/SKILL.md +39 -0
- package/skills/business/rewards/hupu-vatask/SKILL.md +63 -0
- package/skills/business/rewards/hupu-vatask-complete-reward-video/SKILL.md +43 -0
- package/skills/business/rewards/hupu-vatask-consume-activity-chance/SKILL.md +48 -0
- package/skills/business/rewards/hupu-vatask-get-activity-task-state/SKILL.md +49 -0
- package/skills/business/runtime/README.md +13 -0
- package/skills/business/runtime/hupu-add-to-desktop/SKILL.md +51 -0
- package/skills/business/runtime/hupu-close-webview/SKILL.md +48 -0
- package/skills/business/runtime/hupu-cloud-auth/SKILL.md +43 -0
- package/skills/business/runtime/hupu-cloud-request/SKILL.md +56 -0
- package/skills/business/runtime/hupu-fullscreen-safe-top/SKILL.md +33 -0
- package/skills/business/runtime/hupu-navigate-to/SKILL.md +45 -0
- package/skills/business/runtime/hupu-request/SKILL.md +67 -0
- package/skills/business/runtime/hupu-seer-chat/SKILL.md +183 -0
- package/skills/business/runtime/hupu-track-report/SKILL.md +71 -0
- package/skills/business/sharing/README.md +7 -0
- package/skills/business/sharing/hupu-oss-upload-file/SKILL.md +40 -0
- package/skills/business/sharing/hupu-result-poster-posting/SKILL.md +37 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/README.md +14 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/cloudfunctions/activity_api/.cloudignore +3 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/cloudfunctions/activity_api/index.js +187 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/cloudfunctions/activity_api/package.json +15 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/cloudfunctions/activity_api/scf_bootstrap +3 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/index.html +256 -0
- package/skills/business/sharing/hupu-result-poster-posting/example/migrations/20260828213000_create_result_poster_results.sql +60 -0
- package/skills/business/sharing/hupu-result-poster-posting/references/api-contract.md +46 -0
- package/skills/business/sharing/hupu-social-share/SKILL.md +27 -0
- package/skills/business/sports/README.md +27 -0
- package/skills/business/sports/hupu-request-basketball-player-info/SKILL.md +131 -0
- package/skills/business/sports/hupu-request-basketball-single-match/SKILL.md +158 -0
- package/skills/business/sports/hupu-request-basketball-team-info/SKILL.md +96 -0
- package/skills/business/sports/hupu-request-basketball-team-player-list/SKILL.md +108 -0
- package/skills/business/sports/hupu-request-basketball-team-salary-info/SKILL.md +85 -0
- package/skills/business/sports/hupu-request-football-coach-info/SKILL.md +76 -0
- package/skills/business/sports/hupu-request-football-live-room-news-list/SKILL.md +85 -0
- package/skills/business/sports/hupu-request-football-match-info/SKILL.md +126 -0
- package/skills/business/sports/hupu-request-football-player-info/SKILL.md +82 -0
- package/skills/business/sports/hupu-request-football-team-info/SKILL.md +83 -0
- package/skills/business/sports/hupu-request-football-team-player-season-stats/SKILL.md +73 -0
- package/skills/business/sports/hupu-request-football-team-season-year/SKILL.md +68 -0
- package/skills/business/sports/hupu-request-kog-playbyplay/SKILL.md +77 -0
- package/skills/business/sports/hupu-request-live-tab-info-list/SKILL.md +85 -0
- package/skills/business/sports/hupu-request-live-tab-list/SKILL.md +66 -0
- package/skills/business/sports/hupu-request-lol-playbyplay/SKILL.md +77 -0
- package/skills/business/sports/hupu-request-match-get-tab-detail-schedule-list/SKILL.md +113 -0
- package/skills/business/sports/hupu-request-match-query-all-diagram-info-by-id/SKILL.md +79 -0
- package/skills/business/sports/hupu-request-match-query-match-stats-by-match-info/SKILL.md +85 -0
- package/skills/business/sports/hupu-request-news-news-common-list/SKILL.md +90 -0
- package/skills/business/sports/hupu-request-news-player-news-list/SKILL.md +79 -0
- package/skills/business/sports/hupu-request-news-subject-news/SKILL.md +89 -0
- package/skills/business/sports/hupu-request-news-team-news-list/SKILL.md +76 -0
- package/skills/business/storage/README.md +9 -0
- package/skills/business/storage/hupu-cloud-save/SKILL.md +129 -0
- package/skills/business/storage/hupu-cloud-save/references/legacy-migration.md +111 -0
- package/skills/business/storage/hupu-cloud-save-load/SKILL.md +41 -0
- package/skills/business/storage/hupu-cloud-save-save/SKILL.md +45 -0
- package/skills/business/storage/hupu-storage-get-value/SKILL.md +26 -0
- package/skills/business/storage/hupu-storage-set-value/SKILL.md +42 -0
- package/skills/business/user/README.md +6 -0
- package/skills/business/user/hupu-auth-get-user-info/SKILL.md +47 -0
- package/skills/business/user/hupu-game-auth/SKILL.md +46 -0
- package/skills/core/hupu-business/SKILL.md +1 -1
- package/skills/core/hupu-business/references/runtime.md +17 -11
- package/skills/core/shaper-backend/SKILL.md +1 -1
- package/skills/core/shaper-backend/references/database.md +2 -2
- package/skills/core/shaper-backend/references/legacy.md +1 -1
- package/skills/core/shaper-backend/references/node-server.md +29 -20
- package/skills/core/shaper-development/SKILL.md +5 -1
- package/skills/core/shaper-development/references/project-setup.md +1 -1
- package/skills/core/shaper-game-development/SKILL.md +1 -1
- package/skills/core/shaper-release/SKILL.md +1 -1
- package/templates/cloud-service/README.md +4 -30
- package/templates/cloud-service/cloud.json +5 -8
- package/templates/cloud-service/package-lock.json +922 -15
- package/templates/cloud-service/release.json +4 -4
- package/templates/cloud-service/server.cjs +37 -0
- package/templates/leaderboard/README.md +3 -0
- package/templates/leaderboard/cloud/database/migrations/202611130001_leaderboard.sql +6 -0
- package/templates/leaderboard/cloud/functions/api/cloud.json +10 -0
- package/templates/leaderboard/cloud/functions/api/leaderboard.cjs +49 -0
- package/templates/leaderboard/cloud/functions/api/package-lock.json +1093 -0
- package/templates/leaderboard/cloud/functions/api/package.json +19 -0
- package/templates/leaderboard/cloud/functions/api/server.cjs +25 -0
- package/templates/leaderboard/cloud/gateway/routes.json +15 -0
- package/templates/leaderboard/docs/design.md +1 -0
- package/templates/leaderboard/docs/integration.md +12 -0
- package/templates/leaderboard/docs/product.md +1 -0
- package/templates/leaderboard/docs/validation.md +1 -0
- package/templates/leaderboard/index.html +12 -0
- package/templates/leaderboard/package-lock.json +828 -0
- package/templates/leaderboard/package.json +17 -0
- package/templates/leaderboard/public/.gitkeep +1 -0
- package/templates/leaderboard/shaper.config.json +7 -0
- package/templates/leaderboard/src/main.js +67 -0
- package/templates/leaderboard/src/style.css +69 -0
- package/templates/leaderboard/test/leaderboard.test.cjs +93 -0
- package/templates/offline-game/README.md +3 -0
- package/templates/offline-game/docs/design.md +1 -0
- package/templates/offline-game/docs/integration.md +10 -0
- package/templates/offline-game/docs/product.md +1 -0
- package/templates/offline-game/docs/validation.md +1 -0
- package/templates/offline-game/index.html +1 -0
- package/templates/offline-game/package-lock.json +828 -0
- package/templates/offline-game/package.json +16 -0
- package/templates/offline-game/public/.gitkeep +1 -0
- package/templates/offline-game/shaper.config.json +7 -0
- package/templates/offline-game/src/game.js +11 -0
- package/templates/offline-game/src/main.js +12 -0
- package/templates/offline-game/src/style.css +1 -0
- package/templates/offline-game/test/game.test.js +7 -0
- package/dist/shared-APGA5MU5.js +0 -19
- package/templates/cloud-service/handlers.cjs +0 -46
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-kog-playbyplay
|
|
3
|
+
description: 获取王者荣耀比赛的实时赛况,包括对阵双方、队徽、比分与赛制信息,用于展示比赛结果与进展。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.kog.playbyplay(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
|
|
13
|
+
- 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
|
|
14
|
+
- 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
|
|
15
|
+
- SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
|
|
16
|
+
- 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
|
|
17
|
+
|
|
18
|
+
# Parameters
|
|
19
|
+
|
|
20
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
21
|
+
| --- | --- | --- | --- |
|
|
22
|
+
| battleId | string | 是 | 比赛对局唯一ID,例如 "1543468880035840" |
|
|
23
|
+
|
|
24
|
+
# Returns
|
|
25
|
+
|
|
26
|
+
- Type: `Promise<Response>`
|
|
27
|
+
|
|
28
|
+
### Response Properties
|
|
29
|
+
|
|
30
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
31
|
+
| --- | --- | --- | --- |
|
|
32
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
33
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
34
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
35
|
+
| data.scoreboard | object | 否 | 计分板信息 |
|
|
36
|
+
| data.scoreboard.bo | number | 否 | 几局制对决(如 5) |
|
|
37
|
+
| data.scoreboard.status | object | 否 | |
|
|
38
|
+
| data.scoreboard.status.id | number | 否 | |
|
|
39
|
+
| data.scoreboard.status.desc | string | 否 | 比赛状态描述(如 已结束) |
|
|
40
|
+
| data.scoreboard.liveSourceInfos | array | 否 | 直播源信息列表(可能为 null) |
|
|
41
|
+
| data.scoreboard.liveSourceInfos[].liveSourceName | string | 否 | 直播源名称 |
|
|
42
|
+
| data.scoreboard.liveSourceInfos[].liveSourceUrl | string | 否 | 直播源跳转 URL |
|
|
43
|
+
| data.scoreboard.specimenInfos | array | 否 | 集锦信息列表 |
|
|
44
|
+
| data.scoreboard.specimenInfos[].specimensName | string | 否 | 集锦名称 |
|
|
45
|
+
| data.scoreboard.specimenInfos[].specimensUrl | string | 否 | 集锦跳转 URL |
|
|
46
|
+
| data.scoreboard.schedule_at | number | 否 | 开赛时间戳(秒) |
|
|
47
|
+
| data.scoreboard.team1_win_count | number | 否 | 战队1胜场数 |
|
|
48
|
+
| data.scoreboard.team2_win_count | number | 否 | 战队2胜场数 |
|
|
49
|
+
| data.scoreboard.sportName | string | 否 | 赛事名称(如 KPL夏季赛) |
|
|
50
|
+
| data.scoreboard.matchTypeName | string | 否 | 阶段名称(如 第一轮-第二轮) |
|
|
51
|
+
| data.scoreboard.team1_name | string | 否 | 战队1名称(如 重庆狼队) |
|
|
52
|
+
| data.scoreboard.team1_logo | string | 否 | 战队1队徽 URL |
|
|
53
|
+
| data.scoreboard.team1_link | string | 否 | 战队1详情跳转链接 |
|
|
54
|
+
| data.scoreboard.team2_name | string | 否 | 战队2名称(如 上海EDG.M) |
|
|
55
|
+
| data.scoreboard.team2_logo | string | 否 | 战队2队徽 URL |
|
|
56
|
+
| data.scoreboard.team2_link | string | 否 | 战队2详情跳转链接 |
|
|
57
|
+
| data.refresh_time | number | 否 | 刷新间隔时间(秒) |
|
|
58
|
+
|
|
59
|
+
# Examples
|
|
60
|
+
|
|
61
|
+
```javascript
|
|
62
|
+
window.ShaperAI.request.kog.playbyplay({ battleId: "1543468880035840" }).then(res => { if (res.code === 200) { console.log(res.data.scoreboard.team1_name + " vs " + res.data.scoreboard.team2_name); } })
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
# Frontend Request Guard
|
|
66
|
+
|
|
67
|
+
| 策略 | 默认值 |
|
|
68
|
+
| --- | --- |
|
|
69
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
70
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
71
|
+
| 请求超时 | 8000ms |
|
|
72
|
+
| 单能力最大并发 | 不限制 |
|
|
73
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
74
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
75
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
76
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
77
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-live-tab-info-list
|
|
3
|
+
description: 获取通用赛事直播间资讯 Tab 下的新闻/视频列表,包含标题、封面、互动数据、跳转链接和展示状态,适合在赛程直播间中渲染资讯流。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.liveTab.infoList(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 业务渲染列表从 res.data.result 读取,分页游标使用上一页 result 最后一项的 nid。
|
|
13
|
+
- 必须根据返回的 code 判断是否成功;code 等于 200 后再读取 data.result。
|
|
14
|
+
- 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
|
|
15
|
+
- 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
|
|
16
|
+
- 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
|
|
17
|
+
- SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
|
|
18
|
+
|
|
19
|
+
# Parameters
|
|
20
|
+
|
|
21
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
22
|
+
| --- | --- | --- | --- |
|
|
23
|
+
| matchId | string | 是 | 比赛唯一 ID,例如 "3512534" |
|
|
24
|
+
| matchType | string | 是 | 赛事类型/业务分类,如 basketball、football、common_match、lol、kog 等 |
|
|
25
|
+
| newsId | string | 否 | 分页游标,取上一页 data.result 数组最后一项的 nid;首页不传或传 "0" |
|
|
26
|
+
|
|
27
|
+
# Returns
|
|
28
|
+
|
|
29
|
+
- Type: `Promise<Response>`
|
|
30
|
+
|
|
31
|
+
### Response Properties
|
|
32
|
+
|
|
33
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
34
|
+
| --- | --- | --- | --- |
|
|
35
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
36
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
37
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
38
|
+
| data.errorCode | string | 否 | 业务错误码;成功时通常为空字符串 |
|
|
39
|
+
| data.errorMsg | string | 否 | 业务错误信息;成功时通常为空字符串 |
|
|
40
|
+
| data.result | array | 否 | 直播间资讯 Tab 列表 |
|
|
41
|
+
| data.result[].nid | string | 否 | 资讯/新闻唯一 ID,分页时可取列表最后一项的该字段作为 newsId |
|
|
42
|
+
| data.result[].tid | string | 否 | 关联帖子/话题 ID |
|
|
43
|
+
| data.result[].type | string | 否 | 内容展示类型,如 VIDEO、IMG_TEXT、IMAGE_TOP_TEXT_BOTTOM |
|
|
44
|
+
| data.result[].title | string | 否 | 资讯标题 |
|
|
45
|
+
| data.result[].img | string | 否 | 封面图 URL |
|
|
46
|
+
| data.result[].replies | number | 否 | 回复数 |
|
|
47
|
+
| data.result[].lights | number | 否 | 亮评/点亮数 |
|
|
48
|
+
| data.result[].link | string | 否 | 资讯跳转链接,如 kanqiu://bbs/topic/{tid} |
|
|
49
|
+
| data.result[].linkType | string / null | 否 | 链接类型,可能为 null |
|
|
50
|
+
| data.result[].badge | array | 否 | 角标列表,可能为空数组 |
|
|
51
|
+
| data.result[].badge[] | object | 否 | 角标项 |
|
|
52
|
+
| data.result[].publishTime | string | 否 | 发布时间,格式如 "2026-07-19 21:58:09" |
|
|
53
|
+
| data.result[].addTime | number | 否 | 添加/发布时间戳,单位秒 |
|
|
54
|
+
| data.result[].oldNewsId | string / null | 否 | 旧版新闻 ID,可能为 null |
|
|
55
|
+
| data.result[].top | boolean | 否 | 是否置顶 |
|
|
56
|
+
| data.result[].pv | number / string / null | 否 | 浏览量/PV,可能为 null |
|
|
57
|
+
| data.result[].gifList | array / null | 否 | 动图列表,可能为 null |
|
|
58
|
+
| data.result[].gifList[] | object | 否 | 动图项 |
|
|
59
|
+
| data.result[].read | string | 否 | 已读标识,通常与 nid 相同 |
|
|
60
|
+
| data.result[].showComment | number | 否 | 是否展示评论,1 表示展示,0 表示不展示 |
|
|
61
|
+
| data.success | boolean | 否 | 业务是否成功 |
|
|
62
|
+
| data.traceId | string / null | 否 | 链路追踪 ID,可能为 null |
|
|
63
|
+
| data.hostName | string | 否 | 服务节点主机名 |
|
|
64
|
+
| data.msg | string | 否 | 返回消息,成功时可能为空字符串 |
|
|
65
|
+
| data.status | number | 否 | 业务状态码,200 表示成功 |
|
|
66
|
+
|
|
67
|
+
# Examples
|
|
68
|
+
|
|
69
|
+
```javascript
|
|
70
|
+
window.ShaperAI.request.liveTab.infoList({ matchId: "3512534", matchType: "football" }).then(res => { if (res.code === 200) { console.log(res.data.result); } })
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
# Frontend Request Guard
|
|
74
|
+
|
|
75
|
+
| 策略 | 默认值 |
|
|
76
|
+
| --- | --- |
|
|
77
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
78
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
79
|
+
| 请求超时 | 8000ms |
|
|
80
|
+
| 单能力最大并发 | 不限制 |
|
|
81
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
82
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
83
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
84
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
85
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,66 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-live-tab-list
|
|
3
|
+
description: 获取篮球/足球/电竞/通用赛事直播间的 Tab 功能模块列表及默认展示项。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.liveTab.list(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
|
|
13
|
+
- 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
|
|
14
|
+
- 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
|
|
15
|
+
- SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
|
|
16
|
+
- 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
|
|
17
|
+
|
|
18
|
+
# Parameters
|
|
19
|
+
|
|
20
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
21
|
+
| --- | --- | --- | --- |
|
|
22
|
+
| matchId | string | 是 | 比赛唯一ID,例如 "3512534" |
|
|
23
|
+
| matchType | string | 是 | 赛事类型:basketball(篮球)、football(足球)、common_match(通用)、lol(英雄联盟)、kog(王者荣耀) |
|
|
24
|
+
|
|
25
|
+
# Returns
|
|
26
|
+
|
|
27
|
+
- Type: `Promise<Response>`
|
|
28
|
+
|
|
29
|
+
### Response Properties
|
|
30
|
+
|
|
31
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
32
|
+
| --- | --- | --- | --- |
|
|
33
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
34
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
35
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
36
|
+
| data.matchId | string | 否 | 比赛唯一ID |
|
|
37
|
+
| data.matchStatus | string | 否 | 比赛状态(如 COMPLETED 等) |
|
|
38
|
+
| data.matchStatusDesc | string | 否 | 比赛状态描述(如 已结束) |
|
|
39
|
+
| data.defaultCategoryId | string | 否 | 默认定位展示的 tab 标识 |
|
|
40
|
+
| data.categoryList | array | 否 | Tab 导航项列表 |
|
|
41
|
+
| data.categoryList[].categoryId | string | 否 | Tab 标识(如 live_score, live_room 等) |
|
|
42
|
+
| data.categoryList[].categoryName | string | 否 | Tab 呈现中文名(如 虎扑评分, 直播) |
|
|
43
|
+
| data.categoryList[].link | string | 否 | 点击跳转的跳转协议(Schema / H5链接) |
|
|
44
|
+
| data.categoryList[].pv | string | 否 | 曝光量(PV)统计,可能为空字符串 |
|
|
45
|
+
| data.categoryList[].auditShow | boolean / null | 否 | 审核展示开关,null 表示无控制,false 表示不展示 |
|
|
46
|
+
| data.categoryList[].linkVersionMap | object / null | 否 | 不同版本跳转链接映射,可能为 null |
|
|
47
|
+
|
|
48
|
+
# Examples
|
|
49
|
+
|
|
50
|
+
```javascript
|
|
51
|
+
window.ShaperAI.request.liveTab.list({ matchId: "3512534", matchType: "football" }).then(res => { if (res.code === 200) { console.log(res.data.categoryList); } })
|
|
52
|
+
```
|
|
53
|
+
|
|
54
|
+
# Frontend Request Guard
|
|
55
|
+
|
|
56
|
+
| 策略 | 默认值 |
|
|
57
|
+
| --- | --- |
|
|
58
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
59
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
60
|
+
| 请求超时 | 8000ms |
|
|
61
|
+
| 单能力最大并发 | 不限制 |
|
|
62
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
63
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
64
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
65
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
66
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,77 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-lol-playbyplay
|
|
3
|
+
description: 获取英雄联盟比赛的实时赛况,包括对阵双方、队徽、比分与赛制信息,用于展示比赛结果与进展。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.lol.playbyplay(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
|
|
13
|
+
- 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
|
|
14
|
+
- 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
|
|
15
|
+
- SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
|
|
16
|
+
- 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
|
|
17
|
+
|
|
18
|
+
# Parameters
|
|
19
|
+
|
|
20
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
21
|
+
| --- | --- | --- | --- |
|
|
22
|
+
| battleId | string | 是 | 比赛对局唯一ID,例如 "1527692938526720" |
|
|
23
|
+
|
|
24
|
+
# Returns
|
|
25
|
+
|
|
26
|
+
- Type: `Promise<Response>`
|
|
27
|
+
|
|
28
|
+
### Response Properties
|
|
29
|
+
|
|
30
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
31
|
+
| --- | --- | --- | --- |
|
|
32
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
33
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
34
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
35
|
+
| data.scoreboard | object | 否 | 计分板信息 |
|
|
36
|
+
| data.scoreboard.bo | number | 否 | 几局制对决(如 5) |
|
|
37
|
+
| data.scoreboard.status | object | 否 | |
|
|
38
|
+
| data.scoreboard.status.id | number | 否 | |
|
|
39
|
+
| data.scoreboard.status.desc | string | 否 | 比赛状态描述(如 已结束) |
|
|
40
|
+
| data.scoreboard.liveSourceInfos | array | 否 | 直播源信息列表(可能为 null) |
|
|
41
|
+
| data.scoreboard.liveSourceInfos[].liveSourceName | string | 否 | 直播源名称 |
|
|
42
|
+
| data.scoreboard.liveSourceInfos[].liveSourceUrl | string | 否 | 直播源跳转 URL |
|
|
43
|
+
| data.scoreboard.specimenInfos | array | 否 | 集锦信息列表 |
|
|
44
|
+
| data.scoreboard.specimenInfos[].specimensName | string | 否 | 集锦名称 |
|
|
45
|
+
| data.scoreboard.specimenInfos[].specimensUrl | string | 否 | 集锦跳转 URL |
|
|
46
|
+
| data.scoreboard.schedule_at | number | 否 | 开赛时间戳(秒) |
|
|
47
|
+
| data.scoreboard.team1_win_count | number | 否 | 战队1胜场数 |
|
|
48
|
+
| data.scoreboard.team2_win_count | number | 否 | 战队2胜场数 |
|
|
49
|
+
| data.scoreboard.sportName | string | 否 | 赛事名称(如 季中冠军赛) |
|
|
50
|
+
| data.scoreboard.matchTypeName | string | 否 | 阶段名称(如 淘汰赛) |
|
|
51
|
+
| data.scoreboard.team1_name | string | 否 | 战队1名称(如 HLE) |
|
|
52
|
+
| data.scoreboard.team1_logo | string | 否 | 战队1队徽 URL |
|
|
53
|
+
| data.scoreboard.team1_link | string | 否 | 战队1详情跳转链接 |
|
|
54
|
+
| data.scoreboard.team2_name | string | 否 | 战队2名称(如 BLG) |
|
|
55
|
+
| data.scoreboard.team2_logo | string | 否 | 战队2队徽 URL |
|
|
56
|
+
| data.scoreboard.team2_link | string | 否 | 战队2详情跳转链接 |
|
|
57
|
+
| data.refresh_time | number | 否 | 刷新间隔时间(秒) |
|
|
58
|
+
|
|
59
|
+
# Examples
|
|
60
|
+
|
|
61
|
+
```javascript
|
|
62
|
+
window.ShaperAI.request.lol.playbyplay({ battleId: "1527692938526720" }).then(res => { if (res.code === 200) { console.log(res.data.scoreboard.team1_name + " vs " + res.data.scoreboard.team2_name); } })
|
|
63
|
+
```
|
|
64
|
+
|
|
65
|
+
# Frontend Request Guard
|
|
66
|
+
|
|
67
|
+
| 策略 | 默认值 |
|
|
68
|
+
| --- | --- |
|
|
69
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
70
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
71
|
+
| 请求超时 | 8000ms |
|
|
72
|
+
| 单能力最大并发 | 不限制 |
|
|
73
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
74
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
75
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
76
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
77
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,113 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-match-get-tab-detail-schedule-list
|
|
3
|
+
description: 查看赛程各场次的详细信息,并可获取每场比赛关联的评分对象,方便活动页挂载打分入口。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.match.getTabDetailScheduleList(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
|
|
13
|
+
- 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
|
|
14
|
+
- 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
|
|
15
|
+
- SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
|
|
16
|
+
- 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
|
|
17
|
+
|
|
18
|
+
# Parameters
|
|
19
|
+
|
|
20
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
21
|
+
| --- | --- | --- | --- |
|
|
22
|
+
| params | object | 否 | 透传给赛程接口的查询参数 |
|
|
23
|
+
|
|
24
|
+
# Returns
|
|
25
|
+
|
|
26
|
+
- Type: `Promise<Response>`
|
|
27
|
+
|
|
28
|
+
### Response Properties
|
|
29
|
+
|
|
30
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
31
|
+
| --- | --- | --- | --- |
|
|
32
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
33
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
34
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
35
|
+
| data.result | object | 否 | 赛程列表及关联的 scoreItemKey |
|
|
36
|
+
| data.result.anchorMatchId | string | 否 | 定位用比赛 ID(无则为空字符串) |
|
|
37
|
+
| data.result.dayGameData | array | 否 | 按天分组的赛程列表 |
|
|
38
|
+
| data.result.dayGameData[].dayTime | string | 否 | 日期(如 2026-07-01) |
|
|
39
|
+
| data.result.dayGameData[].dateBlock | string | 否 | 日期展示文案(如 7月1日 周三) |
|
|
40
|
+
| data.result.dayGameData[].matchData | array | 否 | 当天场次列表 |
|
|
41
|
+
| data.result.dayGameData[].matchData[].businessType | string | 否 | 业务类型(如 common_match) |
|
|
42
|
+
| data.result.dayGameData[].matchData[].matchId | string | 否 | 比赛唯一 ID |
|
|
43
|
+
| data.result.dayGameData[].matchData[].uniqueKey | string | 否 | 唯一键(如 common_match:1441778164564949622) |
|
|
44
|
+
| data.result.dayGameData[].matchData[].subMatchBusinessType | string | 否 | 子业务类型(如 common_match) |
|
|
45
|
+
| data.result.dayGameData[].matchData[].matchType | string | 否 | 比赛类型(如 against 对阵) |
|
|
46
|
+
| data.result.dayGameData[].matchData[].matchStatus | string | 否 | 比赛状态(如 COMPLETED) |
|
|
47
|
+
| data.result.dayGameData[].matchData[].matchStatusDesc | string | 否 | 比赛状态文案(如 已结束) |
|
|
48
|
+
| data.result.dayGameData[].matchData[].matchStartTimeStamp | string | 否 | 开赛时间戳(毫秒字符串) |
|
|
49
|
+
| data.result.dayGameData[].matchData[].matchStartDate | string | 否 | 开赛日期(如 2026-07-01) |
|
|
50
|
+
| data.result.dayGameData[].matchData[].liveRoomLink | string | 否 | 直播间跳转 schema |
|
|
51
|
+
| data.result.dayGameData[].matchData[].extraPhotoLink | string | 否 | 额外图片链接(无则为空字符串) |
|
|
52
|
+
| data.result.dayGameData[].matchData[].matchIntroduction | string | 否 | 赛事介绍文案 |
|
|
53
|
+
| data.result.dayGameData[].matchData[].matchName | string | 否 | 项目名称(如 女单、男双) |
|
|
54
|
+
| data.result.dayGameData[].matchData[].matchDesc | string | 否 | 比赛描述(可能为 null) |
|
|
55
|
+
| data.result.dayGameData[].matchData[].scoreCountText | string | 否 | 评分人数文案(如 69人评分) |
|
|
56
|
+
| data.result.dayGameData[].matchData[].againstInfo | object | 否 | 对阵信息 |
|
|
57
|
+
| data.result.dayGameData[].matchData[].againstInfo.memberInfos | array | 否 | 对阵双方成员列表 |
|
|
58
|
+
| data.result.dayGameData[].matchData[].againstInfo.memberInfos[].memberName | string | 否 | 成员名称(如球员名、组合名) |
|
|
59
|
+
| data.result.dayGameData[].matchData[].againstInfo.memberInfos[].memberLogo | string | 否 | 成员头像/Logo URL |
|
|
60
|
+
| data.result.dayGameData[].matchData[].againstInfo.memberInfos[].memberBaseScore | string | 否 | 基础比分(字符串,如 "3"、"0") |
|
|
61
|
+
| data.result.dayGameData[].matchData[].againstInfo.memberInfos[].memberExtraScore | string | 否 | 额外比分(可能为 null) |
|
|
62
|
+
| data.result.dayGameData[].matchData[].againstInfo.memberInfos[].memberBigScore | string | 否 | 大比分(可能为 null) |
|
|
63
|
+
| data.result.dayGameData[].matchData[].againstInfo.memberInfos[].memberId | string | 否 | 成员唯一 ID |
|
|
64
|
+
| data.result.dayGameData[].matchData[].againstInfo.memberInfos[].memberType | string | 否 | 成员类型(无则为空字符串) |
|
|
65
|
+
| data.result.dayGameData[].matchData[].againstInfo.memberInfos[].memberDesc | string | 否 | 成员描述(无则为空字符串) |
|
|
66
|
+
| data.result.dayGameData[].matchData[].againstInfo.winnerMemberId | string | 否 | 获胜方成员 ID |
|
|
67
|
+
| data.result.dayGameData[].matchData[].midGameStageInfo | object | 否 | 中场阶段信息(可能为 null) |
|
|
68
|
+
| data.result.dayGameData[].matchData[].scoreItemInfo | object | 否 | 评分卡片信息(可能为 null) |
|
|
69
|
+
| data.result.dayGameData[].matchData[].scoreItemInfo.logo | string | 否 | 评分对象头像 URL |
|
|
70
|
+
| data.result.dayGameData[].matchData[].scoreItemInfo.name | string | 否 | 评分对象名称 |
|
|
71
|
+
| data.result.dayGameData[].matchData[].scoreItemInfo.scoreNum | string | 否 | 评分数值(如 "9.4") |
|
|
72
|
+
| data.result.dayGameData[].matchData[].scoreItemInfo.hotComment | string | 否 | 热评文案 |
|
|
73
|
+
| data.result.dayGameData[].matchData[].scoreItemInfo.scoreCountText | string | 否 | 评分人数文案(如 "55人评分") |
|
|
74
|
+
| data.result.dayGameData[].matchData[].scoreItemInfo.jumpLink | string | 否 | 评分详情跳转 schema |
|
|
75
|
+
| data.result.dayGameData[].matchData[].scoreItemInfo.teamLogo | string | 否 | 队伍 Logo(可能为 null) |
|
|
76
|
+
| data.result.dayGameData[].matchData[].scoreItemInfo.scoreOutBizType | string | 否 | 评分业务类型(如 common_sports_second) |
|
|
77
|
+
| data.result.dayGameData[].matchData[].scoreItemInfo.scoreOutBizNo | string | 否 | 评分业务号 |
|
|
78
|
+
| data.result.dayGameData[].matchData[].customDescInfo | object | 否 | 自定义描述信息(可能为 null) |
|
|
79
|
+
| data.result.dayGameData[].matchData[].extraInfo | object | 否 | 扩展信息(可能为 null) |
|
|
80
|
+
| data.result.dayGameData[].matchData[].subscribeInfo | object | 否 | 订阅提醒信息 |
|
|
81
|
+
| data.result.dayGameData[].matchData[].subscribeInfo.showSubscribe | boolean | 否 | 是否展示订阅入口 |
|
|
82
|
+
| data.result.dayGameData[].matchData[].subscribeInfo.didSubscribe | boolean | 否 | 是否已订阅(可能为 null) |
|
|
83
|
+
| data.result.dayGameData[].matchData[].subscribeInfo.subScribeTitle | string | 否 | 订阅标题文案 |
|
|
84
|
+
| data.result.dayGameData[].matchData[].subscribeInfo.subScribeType | string | 否 | 订阅类型(如 matchNotice) |
|
|
85
|
+
| data.result.dayGameData[].matchData[].subscribeInfo.subScribeScene | string | 否 | 订阅场景(如 commonMatchNotice) |
|
|
86
|
+
| data.result.dayGameData[].matchData[].subscribeInfo.subScribeBizType | string | 否 | 订阅业务类型(如 commonMatch) |
|
|
87
|
+
| data.result.dayGameData[].matchData[].subscribeInfo.subScribeDesc | string | 否 | 订阅描述(如项目名) |
|
|
88
|
+
| data.result.dayGameData[].matchData[].lastReqTimeStamp | number | 否 | 最近请求时间戳(毫秒) |
|
|
89
|
+
| data.result.dayGameData[].matchData[].liveSourceInfos | array | 否 | 直播源列表(无直播时为空数组) |
|
|
90
|
+
| data.result.dayGameData[].matchData[].liveSourceInfos[] | object | 否 | 数组元素 |
|
|
91
|
+
| data.result.dayGameData[].matchData[].scoreItemKey | object | 否 | 评分对象 Key,用于关联评分数据 |
|
|
92
|
+
| data.result.dayGameData[].matchData[].scoreItemKey.outBizNo | string | 否 | 外部业务号 |
|
|
93
|
+
| data.result.dayGameData[].matchData[].scoreItemKey.outBizType | string | 否 | 外部业务类型(如 common_sports_first) |
|
|
94
|
+
|
|
95
|
+
# Examples
|
|
96
|
+
|
|
97
|
+
```javascript
|
|
98
|
+
window.ShaperAI.request.match.getTabDetailScheduleList({}).then(res => { if (res.code === 200) { console.log(res.data); } })
|
|
99
|
+
```
|
|
100
|
+
|
|
101
|
+
# Frontend Request Guard
|
|
102
|
+
|
|
103
|
+
| 策略 | 默认值 |
|
|
104
|
+
| --- | --- |
|
|
105
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
106
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
107
|
+
| 请求超时 | 8000ms |
|
|
108
|
+
| 单能力最大并发 | 不限制 |
|
|
109
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
110
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
111
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
112
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
113
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,79 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-match-query-all-diagram-info-by-id
|
|
3
|
+
description: 查看赛事积分榜与对阵晋级数据,用于展示赛事的排名和晋级形势。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.match.queryAllDiagramInfoById(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
|
|
13
|
+
- 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
|
|
14
|
+
- 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
|
|
15
|
+
- SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
|
|
16
|
+
- 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
|
|
17
|
+
|
|
18
|
+
# Parameters
|
|
19
|
+
|
|
20
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
21
|
+
| --- | --- | --- | --- |
|
|
22
|
+
| standingsId | string | 是 | 积分榜ID,例如 "9" |
|
|
23
|
+
|
|
24
|
+
# Returns
|
|
25
|
+
|
|
26
|
+
- Type: `Promise<Response>`
|
|
27
|
+
|
|
28
|
+
### Response Properties
|
|
29
|
+
|
|
30
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
31
|
+
| --- | --- | --- | --- |
|
|
32
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
33
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
34
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
35
|
+
| data.standingsName | string | 否 | 积分榜名称 |
|
|
36
|
+
| data.standingsDesc | string | 否 | 积分榜描述(可能为 null) |
|
|
37
|
+
| data.dimensionDetails | array | 否 | 积分榜维度定义列表(表头列) |
|
|
38
|
+
| data.dimensionDetails[].dimensionId | number | 否 | 维度ID |
|
|
39
|
+
| data.dimensionDetails[].dimensionName | string | 否 | 维度名称(如年龄、国籍、积分、排名变化) |
|
|
40
|
+
| data.dimensionDetails[].showPercent | boolean | 否 | 是否以百分比展示 |
|
|
41
|
+
| data.dimensionDetails[].sort | number | 否 | 维度展示排序 |
|
|
42
|
+
| data.dimensionDetails[].defaultSortField | boolean | 否 | 是否为默认排序字段 |
|
|
43
|
+
| data.groupDetails | array | 否 | 积分榜分组列表 |
|
|
44
|
+
| data.groupDetails[].groupId | number | 否 | 分组ID |
|
|
45
|
+
| data.groupDetails[].groupName | string | 否 | 分组名称 |
|
|
46
|
+
| data.groupDetails[].details | array | 否 | 该分组下的成员行列表 |
|
|
47
|
+
| data.groupDetails[].details[].memberId | string | 否 | 成员ID |
|
|
48
|
+
| data.groupDetails[].details[].memberLandingUrl | string | 否 | 成员跳转链接(如百科页) |
|
|
49
|
+
| data.groupDetails[].details[].memberLogo | string | 否 | 成员头像/Logo URL |
|
|
50
|
+
| data.groupDetails[].details[].extraMemberId | string | 否 | 附加成员ID(可能为 null) |
|
|
51
|
+
| data.groupDetails[].details[].memberName | string | 否 | 成员名称 |
|
|
52
|
+
| data.groupDetails[].details[].extraMemberName | string | 否 | 附加成员名称(可能为 null) |
|
|
53
|
+
| data.groupDetails[].details[].sort | number | 否 | 排序序号 |
|
|
54
|
+
| data.groupDetails[].details[].showSort | string | 否 | 展示用排名文案 |
|
|
55
|
+
| data.groupDetails[].details[].dimensionDetails | array | 否 | 该成员各维度的值列表 |
|
|
56
|
+
| data.groupDetails[].details[].dimensionDetails[].dimensionId | number | 否 | 维度ID,对应 dimensionDetails 中的维度 |
|
|
57
|
+
| data.groupDetails[].details[].dimensionDetails[].dimensionImage | string | 否 | 维度配图 URL(如国旗、排名变化箭头,可能为 null 或空字符串) |
|
|
58
|
+
| data.groupDetails[].details[].dimensionDetails[].dimensionValue | string | 否 | 维度展示值 |
|
|
59
|
+
| data.groupDetails[].configInfos | array | 否 | 分组配置信息(可能为空数组) |
|
|
60
|
+
|
|
61
|
+
# Examples
|
|
62
|
+
|
|
63
|
+
```javascript
|
|
64
|
+
window.ShaperAI.request.match.queryAllDiagramInfoById({ standingsId: "9" }).then(res => { if (res.code === 200) { console.log(res.data); } })
|
|
65
|
+
```
|
|
66
|
+
|
|
67
|
+
# Frontend Request Guard
|
|
68
|
+
|
|
69
|
+
| 策略 | 默认值 |
|
|
70
|
+
| --- | --- |
|
|
71
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
72
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
73
|
+
| 请求超时 | 8000ms |
|
|
74
|
+
| 单能力最大并发 | 不限制 |
|
|
75
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
76
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
77
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
78
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
79
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-match-query-match-stats-by-match-info
|
|
3
|
+
description: 查询赛事直播间的完整技术统计与对局比分,用于呈现比赛的详细战况。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.match.queryMatchStatsByMatchInfo(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
|
|
13
|
+
- 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
|
|
14
|
+
- 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
|
|
15
|
+
- SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
|
|
16
|
+
- 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
|
|
17
|
+
|
|
18
|
+
# Parameters
|
|
19
|
+
|
|
20
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
21
|
+
| --- | --- | --- | --- |
|
|
22
|
+
| matchId | string | 是 | 比赛唯一ID,例如 "1441778164564949277" |
|
|
23
|
+
| boNumber | number | 否 | 第几局(0表示全场数据,1, 2, 3...表示单局对局,默认为 0) |
|
|
24
|
+
|
|
25
|
+
# Returns
|
|
26
|
+
|
|
27
|
+
- Type: `Promise<Response>`
|
|
28
|
+
|
|
29
|
+
### Response Properties
|
|
30
|
+
|
|
31
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
32
|
+
| --- | --- | --- | --- |
|
|
33
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
34
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
35
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
36
|
+
| data.stats | array | 否 | 统计组件列表,每个元素对应一个可渲染的统计模块 |
|
|
37
|
+
| data.stats[].componentCode | string | 否 | 组件类型标识(如 list_display_components_fix_row 固定行列表、bo_components 分盘切换、horizontal_display_with_stats 横向数据统计) |
|
|
38
|
+
| data.stats[].defaultAnchor | number | 否 | 默认选中锚点索引(可能为 null) |
|
|
39
|
+
| data.stats[].belongingCamp | string | 否 | 所属阵营(可能为 null) |
|
|
40
|
+
| data.stats[].headingInfo | object | 否 | 表头信息 |
|
|
41
|
+
| data.stats[].headingInfo.tableDataInfo | array | 否 | 表头单元格列表 |
|
|
42
|
+
| data.stats[].headingInfo.tableDataInfo[].showName | string | 否 | 展示文案(如球员名、比分、百分比等,无则为空字符串) |
|
|
43
|
+
| data.stats[].headingInfo.tableDataInfo[].logo | string | 否 | Logo/头像图片 URL(无则为空字符串) |
|
|
44
|
+
| data.stats[].headingInfo.tableDataInfo[].bg | string | 否 | 背景图(可能为 null) |
|
|
45
|
+
| data.stats[].headingInfo.tableDataInfo[].requestValue | string | 否 | 请求参数值(如盘次索引,可能为 null) |
|
|
46
|
+
| data.stats[].headingInfo.tableDataInfo[].sourceData | number | 否 | 原始数值,用于排序或比较(可能为 null) |
|
|
47
|
+
| data.stats[].headingInfo.tableDataInfo[].baikeLink | string | 否 | 百科/资料页跳转链接(可能为 null) |
|
|
48
|
+
| data.stats[].headingInfo.tableDataInfo[].fontColor | string | 否 | 字体颜色(可能为 null) |
|
|
49
|
+
| data.stats[].headingInfo.tableDataInfo[].bgColor | string | 否 | 背景颜色(可能为 null) |
|
|
50
|
+
| data.stats[].headingInfo.memberPosition | string | 否 | 成员位置(如 home、away,表头通常为 null) |
|
|
51
|
+
| data.stats[].headingInfo.memberWinStatus | boolean | 否 | 成员是否获胜(表头通常为 null) |
|
|
52
|
+
| data.stats[].bodyInfo | array | 否 | 表体行列表(可能为 null) |
|
|
53
|
+
| data.stats[].bodyInfo[].bodyDataInfo | array | 否 | 当前行的单元格列表 |
|
|
54
|
+
| data.stats[].bodyInfo[].bodyDataInfo[].showName | string | 否 | 展示文案(如球员名、比分、百分比等,无则为空字符串) |
|
|
55
|
+
| data.stats[].bodyInfo[].bodyDataInfo[].logo | string | 否 | Logo/头像图片 URL(无则为空字符串) |
|
|
56
|
+
| data.stats[].bodyInfo[].bodyDataInfo[].bg | string | 否 | 背景图(可能为 null) |
|
|
57
|
+
| data.stats[].bodyInfo[].bodyDataInfo[].requestValue | string | 否 | 请求参数值(如盘次索引,可能为 null) |
|
|
58
|
+
| data.stats[].bodyInfo[].bodyDataInfo[].sourceData | number | 否 | 原始数值,用于排序或比较(可能为 null) |
|
|
59
|
+
| data.stats[].bodyInfo[].bodyDataInfo[].baikeLink | string | 否 | 百科/资料页跳转链接(可能为 null) |
|
|
60
|
+
| data.stats[].bodyInfo[].bodyDataInfo[].fontColor | string | 否 | 字体颜色(可能为 null) |
|
|
61
|
+
| data.stats[].bodyInfo[].bodyDataInfo[].bgColor | string | 否 | 背景颜色(可能为 null) |
|
|
62
|
+
| data.stats[].bodyInfo[].memberPosition | string | 否 | 成员位置(如 home 主、away 客) |
|
|
63
|
+
| data.stats[].bodyInfo[].memberWinStatus | boolean | 否 | 该成员是否获胜 |
|
|
64
|
+
| data.stats[].separatorInfo | object | 否 | 分隔符信息(可能为 null) |
|
|
65
|
+
| data.pollingConfig | object | 否 | 轮询配置(可能为 null) |
|
|
66
|
+
|
|
67
|
+
# Examples
|
|
68
|
+
|
|
69
|
+
```javascript
|
|
70
|
+
window.ShaperAI.request.match.queryMatchStatsByMatchInfo({ matchId: "1441778164564949277", boNumber: 0 }).then(res => { if (res.code === 200) { console.log(res.data); } })
|
|
71
|
+
```
|
|
72
|
+
|
|
73
|
+
# Frontend Request Guard
|
|
74
|
+
|
|
75
|
+
| 策略 | 默认值 |
|
|
76
|
+
| --- | --- |
|
|
77
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
78
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
79
|
+
| 请求超时 | 8000ms |
|
|
80
|
+
| 单能力最大并发 | 不限制 |
|
|
81
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
82
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
83
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
84
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
85
|
+
| 自动分页建议上限 | 5 页 |
|