@hupu-tech/shaper 0.2.11 → 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 +12 -0
- package/README.md +6 -0
- package/dist/cli.js +2 -2
- package/dist/cloud/client.d.ts +1 -2
- package/dist/cloud/service-build.d.ts +5 -7
- 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 -3
- 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 +6 -9
- package/templates/cloud-service/package-lock.json +1090 -0
- package/templates/cloud-service/release.json +11 -0
- package/templates/cloud-service/server.cjs +37 -0
- package/templates/h5/package-lock.json +40 -40
- 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/templates/phaser/package-lock.json +70 -70
- package/templates/react/package-lock.json +74 -74
- package/dist/shared-F5CQJEWB.js +0 -19
- package/templates/cloud-service/handlers.cjs +0 -46
- package/vendor/cloud-server/hupu-cloud-server-0.1.0.tgz +0 -0
- package/vendor/cloud-server/release.json +0 -12
|
@@ -0,0 +1,131 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-basketball-player-info
|
|
3
|
+
description: 查看篮球球员的基础资料与属性信息,用于球员卡片和详情展示。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.basketball.playerInfo(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
|
+
| playerId | string | 是 | 球员唯一ID,例如 "1305275826765299712" |
|
|
23
|
+
| leagueType | string | 是 | 联赛类型:CBA 或 NBA |
|
|
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.player | object | 否 | 球员详细属性集合 |
|
|
37
|
+
| data.player.playerId | string | 否 | 球员唯一ID |
|
|
38
|
+
| data.player.name | string | 否 | 球员中文名(如 乔丹-米奇) |
|
|
39
|
+
| data.player.alias | string | 否 | 球员别名(如 米奇) |
|
|
40
|
+
| data.player.teamLinkUrl | string | 否 | 球队详情跳转链接 |
|
|
41
|
+
| data.player.teamDayColor | string | 否 | 球队日间主题色(十六进制,无 # 前缀) |
|
|
42
|
+
| data.player.teamNightColor | string | 否 | 球队夜间主题色(十六进制,无 # 前缀) |
|
|
43
|
+
| data.player.teamLogoLink | string | 否 | 球队队徽图片 URL |
|
|
44
|
+
| data.player.age | string | 否 | 年龄(字符串) |
|
|
45
|
+
| data.player.lastSeason | string | 否 | 上赛季信息(可能为 null) |
|
|
46
|
+
| data.player.wage | string | 否 | 工资(可能为 null) |
|
|
47
|
+
| data.player.salary | string | 否 | 薪资(可能为 null) |
|
|
48
|
+
| data.player.salaryRank | string | 否 | 薪资排名(可能为 null) |
|
|
49
|
+
| data.player.country | string | 否 | 国籍(如 美国) |
|
|
50
|
+
| data.player.nativePlace | string | 否 | 籍贯(可能为 null) |
|
|
51
|
+
| data.player.sameCountryCount | number | 否 | 同国籍球员数(可能为 null) |
|
|
52
|
+
| data.player.sameNativePlaceCount | number | 否 | 同籍贯球员数(可能为 null) |
|
|
53
|
+
| data.player.sameCollegeCount | number | 否 | 同大学球员数(可能为 null) |
|
|
54
|
+
| data.player.draftRound | number | 否 | NBA 选秀轮次(可能为 null) |
|
|
55
|
+
| data.player.draftPick | number | 否 | NBA 选秀顺位(可能为 null) |
|
|
56
|
+
| data.player.cbaDraftYear | number | 否 | CBA 选秀年份(可能为 null) |
|
|
57
|
+
| data.player.cbaDraftTeamId | string | 否 | CBA 选秀球队ID |
|
|
58
|
+
| data.player.cbaDraftRound | number | 否 | CBA 选秀轮次(可能为 null) |
|
|
59
|
+
| data.player.cbaDraftPick | number | 否 | CBA 选秀顺位(可能为 null) |
|
|
60
|
+
| data.player.contractDetails | string | 否 | NBA 合同详情(可能为 null) |
|
|
61
|
+
| data.player.cbaContractDetails | string | 否 | CBA 合同详情(可能为 null) |
|
|
62
|
+
| data.player.deathTime | string | 否 | 去世时间(可能为 null) |
|
|
63
|
+
| data.player.deathDate | string | 否 | 去世日期(可能为 null) |
|
|
64
|
+
| data.player.playerLink | string | 否 | 球员详情跳转链接(可能为 null) |
|
|
65
|
+
| data.player.teamName | string | 否 | 当前球队简称(如 青岛) |
|
|
66
|
+
| data.player.teamInfoList | array | 否 | 球员所属球队信息列表 |
|
|
67
|
+
| data.player.teamInfoList[].teamId | string | 否 | 球队ID |
|
|
68
|
+
| data.player.teamInfoList[].leagueType | string | 否 | 联赛类型(如 CBA、NBA) |
|
|
69
|
+
| data.player.teamInfoList[].teamName | string | 否 | 球队简称 |
|
|
70
|
+
| data.player.teamInfoList[].teamFullName | string | 否 | 球队全称 |
|
|
71
|
+
| data.player.teamInfoList[].bbr | string | 否 | 球队 BBR 标识 |
|
|
72
|
+
| data.player.teamInfoList[].dayColor | string | 否 | 日间主题色 |
|
|
73
|
+
| data.player.teamInfoList[].nightColor | string | 否 | 夜间主题色 |
|
|
74
|
+
| data.player.teamInfoList[].shirtNumber | string | 否 | 球衣号码(可能为 null) |
|
|
75
|
+
| data.player.teamInfoList[].logoLink | string | 否 | 队徽图片 URL |
|
|
76
|
+
| data.player.nbaGdcId | number | 否 | NBA GDC ID(可能为 null) |
|
|
77
|
+
| data.player.cbaGdcId | number | 否 | CBA GDC ID(可能为 null) |
|
|
78
|
+
| data.player.gid | number | 否 | 内部 gid |
|
|
79
|
+
| data.player.info | string | 否 | 额外说明信息(可能为 null) |
|
|
80
|
+
| data.player.encyclItemId | number | 否 | 百科词条ID |
|
|
81
|
+
| data.player.leaveTeam | boolean | 否 | 是否已离队 |
|
|
82
|
+
| data.player.countryPhoto | string | 否 | 国旗图片 URL |
|
|
83
|
+
| data.player.eng_name | string | 否 | 英文全名 |
|
|
84
|
+
| data.player.first_name | string | 否 | 英文名 |
|
|
85
|
+
| data.player.last_name | string | 否 | 英文姓 |
|
|
86
|
+
| data.player.nick | string | 否 | 昵称(可能为 null) |
|
|
87
|
+
| data.player.photo | string | 否 | 球员头像小图 URL |
|
|
88
|
+
| data.player.big_photo | string | 否 | 球员头像大图 URL |
|
|
89
|
+
| data.player.number | string | 否 | 球衣号码(如 "55") |
|
|
90
|
+
| data.player.position | string | 否 | 场上位置(如 中锋) |
|
|
91
|
+
| data.player.birth_date | string | 否 | 出生日期(如 1994年07月09日) |
|
|
92
|
+
| data.player.nba_first_year | number | 否 | NBA 首秀年份(可能为 null) |
|
|
93
|
+
| data.player.cba_first_year | number | 否 | CBA 首秀年份 |
|
|
94
|
+
| data.player.height | number | 否 | 身高(米,如 2.03) |
|
|
95
|
+
| data.player.weight | number | 否 | 体重(公斤,如 107) |
|
|
96
|
+
| data.player.draft_year | number | 否 | 选秀年份(可能为 null) |
|
|
97
|
+
| data.player.draft_team_id | string | 否 | 选秀球队ID |
|
|
98
|
+
| data.player.high_school | string | 否 | 高中(可能为 null) |
|
|
99
|
+
| data.player.college_school | string | 否 | 大学(可能为 null) |
|
|
100
|
+
| data.player.wingspan | number | 否 | 臂展(可能为 null) |
|
|
101
|
+
| data.player.standing_reach | number | 否 | 站立摸高(可能为 null) |
|
|
102
|
+
| data.player.territorial_pick | number | 否 | 地区选秀标记 |
|
|
103
|
+
| data.player.team_id | string | 否 | 球队ID(可能为 null) |
|
|
104
|
+
| data.pageTab | array | 否 | 球员页 Tab 列表 |
|
|
105
|
+
| data.pageTab[].title | string | 否 | Tab 标题(如 数据、投篮、生涯) |
|
|
106
|
+
| data.pageTab[].pageLink | string | 否 | Tab 路径(如 /data、/shot) |
|
|
107
|
+
| data.pageTab[].show | boolean | 否 | 是否展示该 Tab |
|
|
108
|
+
| data.tagId | string | 否 | 关联话题标签ID(可能为 null) |
|
|
109
|
+
| data.tagName | string | 否 | 关联话题标签名(可能为 null) |
|
|
110
|
+
| data.tagViewCount | number | 否 | 话题浏览数(可能为 null) |
|
|
111
|
+
| data.tagThreadCount | number | 否 | 话题帖子数(可能为 null) |
|
|
112
|
+
|
|
113
|
+
# Examples
|
|
114
|
+
|
|
115
|
+
```javascript
|
|
116
|
+
window.ShaperAI.request.basketball.playerInfo({ playerId: "1305275826765299712", leagueType: "CBA" }).then(res => { if (res.code === 200) { console.log(res.data.player); } })
|
|
117
|
+
```
|
|
118
|
+
|
|
119
|
+
# Frontend Request Guard
|
|
120
|
+
|
|
121
|
+
| 策略 | 默认值 |
|
|
122
|
+
| --- | --- |
|
|
123
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
124
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
125
|
+
| 请求超时 | 8000ms |
|
|
126
|
+
| 单能力最大并发 | 不限制 |
|
|
127
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
128
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
129
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
130
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
131
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,158 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-basketball-single-match
|
|
3
|
+
description: 获取篮球比赛的实时赛况,包括对阵双方、队徽、比分和比赛状态,用于展示比赛结果与进展。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.basketball.singleMatch(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,例如 "1500260599135731712" |
|
|
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.projectId | string | 否 | 项目ID(内部字段,通常为 null) |
|
|
36
|
+
| data.version | string | 否 | 版本号(内部字段,通常为 null) |
|
|
37
|
+
| data.traceId | string | 否 | 链路追踪ID(内部字段,通常为 null) |
|
|
38
|
+
| data.matchId | string | 否 | 比赛唯一ID |
|
|
39
|
+
| data.matchStatus | string | 否 | 比赛状态(如 COMPLETED, LIVE, NOT_STARTED 等) |
|
|
40
|
+
| data.homeScore | number | 否 | 主队得分 |
|
|
41
|
+
| data.awayScore | number | 否 | 客队得分 |
|
|
42
|
+
| data.homeTeamId | string | 否 | 主队ID |
|
|
43
|
+
| data.awayTeamId | string | 否 | 客队ID |
|
|
44
|
+
| data.homeTeamName | string | 否 | 主队简称(中文) |
|
|
45
|
+
| data.awayTeamName | string | 否 | 客队简称(中文) |
|
|
46
|
+
| data.homeTeamEngName | string | 否 | 主队英文名(可能为 null) |
|
|
47
|
+
| data.awayTeamEngName | string | 否 | 客队英文名(可能为 null) |
|
|
48
|
+
| data.homeTeamLogo | string | 否 | 主队队徽图片 URL |
|
|
49
|
+
| data.awayTeamLogo | string | 否 | 客队队徽图片 URL |
|
|
50
|
+
| data.homeTeamDayColor | string | 否 | 主队日间主题色(十六进制,无 # 前缀) |
|
|
51
|
+
| data.awayTeamDayColor | string | 否 | 客队日间主题色(十六进制,无 # 前缀) |
|
|
52
|
+
| data.homeTeamNightColor | string | 否 | 主队夜间主题色 |
|
|
53
|
+
| data.awayTeamNightColor | string | 否 | 客队夜间主题色 |
|
|
54
|
+
| data.homeTeamSpareColor | string | 否 | 主队备用主题色 |
|
|
55
|
+
| data.awayTeamSpareColor | string | 否 | 客队备用主题色 |
|
|
56
|
+
| data.homeFrontTeam | boolean | 否 | 主队是否为前置展示队伍 |
|
|
57
|
+
| data.snapshotVersion | number | 否 | 数据快照版本号 |
|
|
58
|
+
| data.leagueType | string | 否 | 联赛类型(如 CBA, NBA) |
|
|
59
|
+
| data.competitionType | string | 否 | 赛事类型(如 CBA) |
|
|
60
|
+
| data.competitionTypeCn | string | 否 | 赛事类型中文名(如 CBA) |
|
|
61
|
+
| data.competitionStageType | string | 否 | 比赛阶段类型(如 PLAYOFF、REGULAR) |
|
|
62
|
+
| data.competitionStageDesc | string | 否 | 比赛阶段描述(如 季后赛、常规赛) |
|
|
63
|
+
| data.gdcId | number | 否 | GDC 数据中心比赛ID |
|
|
64
|
+
| data.beginTime | number | 否 | 比赛开始时间(纳秒时间戳) |
|
|
65
|
+
| data.homeGdcId | number | 否 | 主队 GDC ID |
|
|
66
|
+
| data.awayGdcId | number | 否 | 客队 GDC ID |
|
|
67
|
+
| data.homeFouls | number | 否 | 主队犯规数 |
|
|
68
|
+
| data.homeSurplusPause | number | 否 | 主队剩余暂停次数 |
|
|
69
|
+
| data.awayFouls | number | 否 | 客队犯规数 |
|
|
70
|
+
| data.awaySurplusPause | number | 否 | 客队剩余暂停次数 |
|
|
71
|
+
| data.matchStatusChinese | string | 否 | 比赛状态中文描述(如 已结束、直播中、未开始) |
|
|
72
|
+
| data.homeRank | number | 否 | 主队排名 |
|
|
73
|
+
| data.awayRank | number | 否 | 客队排名 |
|
|
74
|
+
| data.homeArea | string | 否 | 主队地区(可能为 null) |
|
|
75
|
+
| data.awayArea | string | 否 | 客队地区(可能为 null) |
|
|
76
|
+
| data.frontEndMatchStatus | object | 否 | 前端比赛状态 |
|
|
77
|
+
| data.frontEndMatchStatus.id | number | 否 | 状态ID |
|
|
78
|
+
| data.frontEndMatchStatus.desc | string | 否 | 状态描述(如 已结束) |
|
|
79
|
+
| data.matchTimeScheduleStatus | string | 否 | 比赛时间安排状态(如 SCHEDULED) |
|
|
80
|
+
| data.attendance | number | 否 | 观众人数(可能为 null) |
|
|
81
|
+
| data.season | string | 否 | 赛季(如 2025-2026) |
|
|
82
|
+
| data.memo | string | 否 | 备注信息(可能为 null) |
|
|
83
|
+
| data.arenaCity | string | 否 | 比赛场馆所在城市(可能为 null) |
|
|
84
|
+
| data.chinaStartTime | number | 否 | 中国时区开赛时间(毫秒时间戳) |
|
|
85
|
+
| data.usaStartTime | number | 否 | 美国时区开赛时间(毫秒时间戳,可能为 null) |
|
|
86
|
+
| data.matchTime | string | 否 | 比赛时间字符串(如 "2026-05-07 20:00:00") |
|
|
87
|
+
| data.costTime | number | 否 | 比赛耗时(可能为 null) |
|
|
88
|
+
| data.currentQuarter | number | 否 | 当前节数 |
|
|
89
|
+
| data.round | number | 否 | 轮次 |
|
|
90
|
+
| data.winTeamName | string | 否 | 获胜队伍简称 |
|
|
91
|
+
| data.openChat | boolean | 否 | 是否开启聊天 |
|
|
92
|
+
| data.openLive | boolean | 否 | 是否开启直播 |
|
|
93
|
+
| data.openCasino | boolean | 否 | 是否开启竞猜 |
|
|
94
|
+
| data.playerscorecount | number | 否 | 球员评分人数(可能为 null) |
|
|
95
|
+
| data.liveOption | string | 否 | 直播方式(如 ARTIFICIAL 人工) |
|
|
96
|
+
| data.lid | string | 否 | 联赛ID |
|
|
97
|
+
| data.matchTvList | array | 否 | 电视转播列表 |
|
|
98
|
+
| data.matchVideoList | array | 否 | 比赛视频列表 |
|
|
99
|
+
| data.liveUrl | string | 否 | 直播间跳转链接 |
|
|
100
|
+
| data.iconText | string | 否 | 角标文案(如 "5.8万") |
|
|
101
|
+
| data.score | string | 否 | 比赛评分(如 "5.8万评分") |
|
|
102
|
+
| data.scoreNumber | number | 否 | 评分人数 |
|
|
103
|
+
| data.sectionEndTime | string | 否 | 各节结束时间(JSON 字符串) |
|
|
104
|
+
| data.homeBigScore | number | 否 | 主队大比分 |
|
|
105
|
+
| data.awayBigScore | number | 否 | 客队大比分 |
|
|
106
|
+
| data.isSubscribe | number | 否 | 是否已订阅(0/1) |
|
|
107
|
+
| data.homeTeamAttention | number | 否 | 主队关注状态(可能为 null) |
|
|
108
|
+
| data.awayTeamAttention | number | 否 | 客队关注状态(可能为 null) |
|
|
109
|
+
| data.shareImg | string | 否 | 分享图片 URL |
|
|
110
|
+
| data.showSubscribe | boolean | 否 | 是否展示订阅按钮 |
|
|
111
|
+
| data.didSubscribe | boolean | 否 | 是否已订阅 |
|
|
112
|
+
| data.subScribeTitle | string | 否 | 订阅标题 |
|
|
113
|
+
| data.subScribeType | string | 否 | 订阅类型(如 matchNotice) |
|
|
114
|
+
| data.subScribeScene | string | 否 | 订阅场景(如 basketballMatchNotice) |
|
|
115
|
+
| data.subScribeBizType | string | 否 | 订阅业务类型(如 basketballMatch) |
|
|
116
|
+
| data.subScribeDesc | string | 否 | 订阅描述(如 "深圳 vs 浙江") |
|
|
117
|
+
| data.liveRoomMsgConfig | object | 否 | 直播间消息配置 |
|
|
118
|
+
| data.liveRoomMsgConfig.polling | object | 否 | 轮询配置 |
|
|
119
|
+
| data.liveRoomMsgConfig.polling.open | boolean | 否 | 是否开启轮询 |
|
|
120
|
+
| data.liveRoomMsgConfig.polling.inProgressIntervalInMillSeconds | number | 否 | 进行中轮询间隔(毫秒) |
|
|
121
|
+
| data.liveRoomMsgConfig.polling.notInProgressIntervalInMillSeconds | number | 否 | 非进行中轮询间隔(毫秒) |
|
|
122
|
+
| data.liveRoomMsgConfig.mqtt | object | 否 | MQTT 配置 |
|
|
123
|
+
| data.liveRoomMsgConfig.mqtt.open | boolean | 否 | 是否开启 MQTT |
|
|
124
|
+
| data.supportLiveActivity | boolean | 否 | 是否支持灵动岛实时活动 |
|
|
125
|
+
| data.matchSpecimens | array | 否 | 比赛样本数据(可能为 null) |
|
|
126
|
+
| data.homeLink | string | 否 | 主队详情跳转链接 |
|
|
127
|
+
| data.awayLink | string | 否 | 客队详情跳转链接 |
|
|
128
|
+
| data.iosliveActivityCode | string | 否 | iOS 实时活动编码(可能为 null) |
|
|
129
|
+
| data.is_login | number | 否 | 是否登录(0/1) |
|
|
130
|
+
| data.is_jrs | boolean | 否 | 是否为极速版 |
|
|
131
|
+
| data.night | number | 否 | 是否夜间模式(0/1) |
|
|
132
|
+
| data.client | string | 否 | 客户端标识(可能为 null) |
|
|
133
|
+
| data.league_en | string | 否 | 联赛英文标识(如 cba) |
|
|
134
|
+
| data.league_name | string | 否 | 联赛名称(如 CBA) |
|
|
135
|
+
| data.ad_inside_pop | object | 否 | 内部广告弹窗配置 |
|
|
136
|
+
| data.ad_inside_pop.ad_type | number | 否 | 广告类型 |
|
|
137
|
+
| data.ad_inside_pop.is_ad | number | 否 | 是否为广告(0/1) |
|
|
138
|
+
| data.ad_inside_pop.position | number | 否 | 广告位置 |
|
|
139
|
+
|
|
140
|
+
# Examples
|
|
141
|
+
|
|
142
|
+
```javascript
|
|
143
|
+
window.ShaperAI.request.basketball.singleMatch({ matchId: "1500260599135731712" }).then(res => { if (res.code === 200) { console.log(res.data.homeTeamName + " vs " + res.data.awayTeamName); } })
|
|
144
|
+
```
|
|
145
|
+
|
|
146
|
+
# Frontend Request Guard
|
|
147
|
+
|
|
148
|
+
| 策略 | 默认值 |
|
|
149
|
+
| --- | --- |
|
|
150
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
151
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
152
|
+
| 请求超时 | 8000ms |
|
|
153
|
+
| 单能力最大并发 | 不限制 |
|
|
154
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
155
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
156
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
157
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
158
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,96 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-basketball-team-info
|
|
3
|
+
description: 获取球队主页的基础资料,包括队名、队徽、主题色、主场与专区入口,用于搭建球队主题页。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.basketball.teamInfo(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 必须通过 window.ShaperAI.request.basketball.teamInfo({ teamId, leagueType }) 调用,严禁直接拼凑网络接口 URL。
|
|
13
|
+
- leagueType 仅支持 nba / cba。
|
|
14
|
+
- 优先从 data.info 读取队名、队徽、主题色;从 data.thread 读取专区信息;从 data.encyclItemId 读取百科对象 ID。
|
|
15
|
+
- 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
|
|
16
|
+
- 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
|
|
17
|
+
- 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
|
|
18
|
+
- SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
|
|
19
|
+
- 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
|
|
20
|
+
|
|
21
|
+
# Parameters
|
|
22
|
+
|
|
23
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
24
|
+
| --- | --- | --- | --- |
|
|
25
|
+
| teamId | string | 是 | 球队唯一 ID,例如 "1901000000501288" |
|
|
26
|
+
| leagueType | string | 是 | 联赛类型:nba 或 cba(大小写均可) |
|
|
27
|
+
|
|
28
|
+
# Returns
|
|
29
|
+
|
|
30
|
+
- Type: `Promise<Response>`
|
|
31
|
+
|
|
32
|
+
### Response Properties
|
|
33
|
+
|
|
34
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
35
|
+
| --- | --- | --- | --- |
|
|
36
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
37
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
38
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
39
|
+
| data.info | object | 否 | 球队基础 Header 信息 |
|
|
40
|
+
| data.info.tid | string | 否 | 球队内部 tid,例如 "10" |
|
|
41
|
+
| data.info.teamId | string | 否 | 球队唯一 ID |
|
|
42
|
+
| data.info.name | string | 否 | 球队简称,例如 骑士 |
|
|
43
|
+
| data.info.full_name | string | 否 | 球队全称,例如 克里夫兰骑士 |
|
|
44
|
+
| data.info.en_name | string | 否 | 球队英文名,例如 Cavaliers |
|
|
45
|
+
| data.info.arena | string | 否 | 主场球馆名称 |
|
|
46
|
+
| data.info.background | string / null | 否 | 背景图,可能为 null |
|
|
47
|
+
| data.info.dayColor | string | 否 | 日间主题色(十六进制,无 # 前缀) |
|
|
48
|
+
| data.info.nightColor | string | 否 | 夜间主题色(十六进制,无 # 前缀) |
|
|
49
|
+
| data.info.rank | string / number / null | 否 | 排名,可能为 null |
|
|
50
|
+
| data.info.wins | number / null | 否 | 胜场,可能为 null |
|
|
51
|
+
| data.info.losses | number / null | 否 | 负场,可能为 null |
|
|
52
|
+
| data.info.homeWins | number / null | 否 | 主场胜场,可能为 null |
|
|
53
|
+
| data.info.homeLosses | number / null | 否 | 主场负场,可能为 null |
|
|
54
|
+
| data.info.awayWins | number / null | 否 | 客场胜场,可能为 null |
|
|
55
|
+
| data.info.awayLosses | number / null | 否 | 客场负场,可能为 null |
|
|
56
|
+
| data.info.area | string / null | 否 | 赛区,可能为 null |
|
|
57
|
+
| data.info.logoLink | string | 否 | 队徽图片 URL |
|
|
58
|
+
| data.info.teamLinkUrl | string | 否 | 球队详情跳转 schema |
|
|
59
|
+
| data.thread | object | 否 | 球队专区信息 |
|
|
60
|
+
| data.thread.name | string | 否 | 专区名称,例如 骑士专区 |
|
|
61
|
+
| data.thread.bbs_tid | number | 否 | 论坛专区 tid |
|
|
62
|
+
| data.thread.bbs_tpid | number | 否 | 论坛话题/版块 tpid |
|
|
63
|
+
| data.thread.followedUserNum | number | 否 | 专区关注人数 |
|
|
64
|
+
| data.is_follow | number | 否 | 当前用户是否已关注,1 表示已关注,0 表示未关注 |
|
|
65
|
+
| data.team_tab | string | 否 | 数据 Tab 文案 |
|
|
66
|
+
| data.team_tab_url | string | 否 | 数据 Tab 跳转链接 |
|
|
67
|
+
| data.salary_tab | string | 否 | 薪资 Tab 文案 |
|
|
68
|
+
| data.salary_tab_show | boolean | 否 | 是否展示薪资 Tab |
|
|
69
|
+
| data.salary_tab_url | string / null | 否 | 薪资 Tab 跳转链接,可能为 null |
|
|
70
|
+
| data.history_tab | string | 否 | 资料 Tab 文案 |
|
|
71
|
+
| data.history_tab_show | boolean | 否 | 是否展示资料 Tab |
|
|
72
|
+
| data.history_tab_url | string / null | 否 | 资料 Tab 跳转链接,可能为 null |
|
|
73
|
+
| data.season_tab | string | 否 | 赛季 Tab 文案 |
|
|
74
|
+
| data.season_tab_show | boolean | 否 | 是否展示赛季 Tab |
|
|
75
|
+
| data.season_tab_url | string / null | 否 | 赛季 Tab 跳转链接,可能为 null |
|
|
76
|
+
| data.encyclItemId | number | 否 | 关联评分百科对象 ID |
|
|
77
|
+
|
|
78
|
+
# Examples
|
|
79
|
+
|
|
80
|
+
```javascript
|
|
81
|
+
window.ShaperAI.request.basketball.teamInfo({ teamId: "1901000000501288", leagueType: "nba" }).then(res => { if (res.code === 200) { console.log(res.data.info?.name, res.data.info?.logoLink); } })
|
|
82
|
+
```
|
|
83
|
+
|
|
84
|
+
# Frontend Request Guard
|
|
85
|
+
|
|
86
|
+
| 策略 | 默认值 |
|
|
87
|
+
| --- | --- |
|
|
88
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
89
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
90
|
+
| 请求超时 | 8000ms |
|
|
91
|
+
| 单能力最大并发 | 不限制 |
|
|
92
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
93
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
94
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
95
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
96
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,108 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-basketball-team-player-list
|
|
3
|
+
description: 查看篮球球队的当前阵容、球员赛季场均数据以及管理层/教练组信息,用于阵容与球员卡片展示。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.basketball.teamPlayerList(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 必须通过 window.ShaperAI.request.basketball.teamPlayerList({ teamId, leagueType }) 调用,严禁直接拼凑网络接口 URL。
|
|
13
|
+
- leagueType 仅支持 nba / cba;未传 competitionType / competitionLeagueType 时默认与 leagueType 一致。
|
|
14
|
+
- 优先从 data.list 读取阵容球员;从 data.offical 读取管理层/教练组;从 data.players_stats_glossary 读取数据字段中英文对照。
|
|
15
|
+
- 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
|
|
16
|
+
- 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
|
|
17
|
+
- 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
|
|
18
|
+
- SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
|
|
19
|
+
- 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
|
|
20
|
+
|
|
21
|
+
# Parameters
|
|
22
|
+
|
|
23
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
24
|
+
| --- | --- | --- | --- |
|
|
25
|
+
| teamId | string | 是 | 球队唯一 ID,例如 "1901000000501288" |
|
|
26
|
+
| leagueType | string | 是 | 联赛类型:nba 或 cba(大小写均可) |
|
|
27
|
+
| competitionType | string | 否 | 赛事类型,默认与 leagueType 相同,例如 nba |
|
|
28
|
+
| competitionLeagueType | string | 否 | 赛事联赛类型,默认与 leagueType 相同,例如 nba |
|
|
29
|
+
|
|
30
|
+
# Returns
|
|
31
|
+
|
|
32
|
+
- Type: `Promise<Response>`
|
|
33
|
+
|
|
34
|
+
### Response Properties
|
|
35
|
+
|
|
36
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
37
|
+
| --- | --- | --- | --- |
|
|
38
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
39
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
40
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
41
|
+
| data.info | object | 否 | 球队基础摘要信息 |
|
|
42
|
+
| data.info.teamId | string | 否 | 球队唯一 ID |
|
|
43
|
+
| data.info.tid | string / null | 否 | 球队内部 tid,可能为 null |
|
|
44
|
+
| data.info.name | string | 否 | 球队简称 |
|
|
45
|
+
| data.info.full_name | string | 否 | 球队全称 |
|
|
46
|
+
| data.info.en_name | string | 否 | 球队英文缩写/名称 |
|
|
47
|
+
| data.info.salary_title | string | 否 | 薪资列标题,例如 薪水(美元) |
|
|
48
|
+
| data.info.arena_title | string | 否 | 主场标题文案 |
|
|
49
|
+
| data.info.logo_link | string | 否 | 队徽图片 URL |
|
|
50
|
+
| data.info.arena | string | 否 | 主场球馆名称 |
|
|
51
|
+
| data.info.rank_title | string | 否 | 战绩标题文案 |
|
|
52
|
+
| data.list | array | 否 | 球队阵容球员列表 |
|
|
53
|
+
| data.list[].playerId | string | 否 | 球员唯一 ID |
|
|
54
|
+
| data.list[].homeUrl | string | 否 | 球员详情页 H5 链接 |
|
|
55
|
+
| data.list[].player_id | number / null | 否 | 球员内部数字 ID,可能为 null |
|
|
56
|
+
| data.list[].player_name | string | 否 | 球员中文名 |
|
|
57
|
+
| data.list[].player_header | string | 否 | 球员头像小图 URL |
|
|
58
|
+
| data.list[].player_header_big | string | 否 | 球员头像大图 URL |
|
|
59
|
+
| data.list[].number | string | 否 | 球衣号码 |
|
|
60
|
+
| data.list[].position | string | 否 | 场上位置,例如 后卫、中锋 |
|
|
61
|
+
| data.list[].salary | string | 否 | 薪资数值字符串,可能为空 |
|
|
62
|
+
| data.list[].salary_str | string | 否 | 薪资展示文案,例如 46394100万 |
|
|
63
|
+
| data.list[].is_injured | number | 否 | 是否受伤,0 表示未受伤 |
|
|
64
|
+
| data.list[].game_played_start | string | 否 | 出场/首发,例如 18/18 |
|
|
65
|
+
| data.list[].min | string | 否 | 场均时间 |
|
|
66
|
+
| data.list[].pts | string | 否 | 场均得分 |
|
|
67
|
+
| data.list[].reb | string | 否 | 场均篮板 |
|
|
68
|
+
| data.list[].asts | string | 否 | 场均助攻 |
|
|
69
|
+
| data.list[].fgp | string | 否 | 投篮命中率,例如 45% |
|
|
70
|
+
| data.list[].tpp | string | 否 | 三分命中率 |
|
|
71
|
+
| data.list[].ftp | string | 否 | 罚球命中率 |
|
|
72
|
+
| data.list[].oreb | string | 否 | 场均前板 |
|
|
73
|
+
| data.list[].dreb | string | 否 | 场均后板 |
|
|
74
|
+
| data.list[].stl | string | 否 | 场均抢断 |
|
|
75
|
+
| data.list[].to | string | 否 | 场均失误 |
|
|
76
|
+
| data.list[].blk | string | 否 | 场均盖帽 |
|
|
77
|
+
| data.list[].pf | string | 否 | 场均犯规 |
|
|
78
|
+
| data.offical | array | 否 | 管理层/教练组列表(接口字段名为 offical) |
|
|
79
|
+
| data.offical[].id | string | 否 | 人员 ID |
|
|
80
|
+
| data.offical[].eng_name | string | 否 | 英文名 |
|
|
81
|
+
| data.offical[].name | string | 否 | 中文名 |
|
|
82
|
+
| data.offical[].birth_date | string / null | 否 | 出生日期,可能为 null |
|
|
83
|
+
| data.offical[].page_link | string | 否 | 详情跳转链接/schema |
|
|
84
|
+
| data.offical[].photo | string | 否 | 头像 URL |
|
|
85
|
+
| data.offical[].category_name | string | 否 | 职位中文名,例如 主教练、总经理 |
|
|
86
|
+
| data.offical[].category | string | 否 | 职位类型,例如 MAIN_COACH、GENERAL_MANAGER、OPERATION_MANAGER |
|
|
87
|
+
| data.players_stats_glossary | array | 否 | 球员数据字段中英文对照,通常为 [英文 key 数组, 中文文案数组] |
|
|
88
|
+
| data.players_stats_glossary[] | array | 否 | 数组元素 |
|
|
89
|
+
|
|
90
|
+
# Examples
|
|
91
|
+
|
|
92
|
+
```javascript
|
|
93
|
+
window.ShaperAI.request.basketball.teamPlayerList({ teamId: "1901000000501288", leagueType: "nba" }).then(res => { if (res.code === 200) { console.log(res.data.list?.length, res.data.list?.[0]?.player_name); } })
|
|
94
|
+
```
|
|
95
|
+
|
|
96
|
+
# Frontend Request Guard
|
|
97
|
+
|
|
98
|
+
| 策略 | 默认值 |
|
|
99
|
+
| --- | --- |
|
|
100
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
101
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
102
|
+
| 请求超时 | 8000ms |
|
|
103
|
+
| 单能力最大并发 | 不限制 |
|
|
104
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
105
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
106
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
107
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
108
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,85 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-basketball-team-salary-info
|
|
3
|
+
description: 查看球队薪资帽概览与球员多年薪资明细,用于呈现球队薪资结构与空间。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.basketball.teamSalaryInfo(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 必须通过 window.ShaperAI.request.basketball.teamSalaryInfo({ teamId, leagueType }) 调用,严禁直接拼凑网络接口 URL。
|
|
13
|
+
- leagueType 仅支持 nba / cba。
|
|
14
|
+
- 优先从 data.salaryGeneralViewPlate 读取总薪资/薪资空间/奢侈税概览;从 data.salaryPlayerTable 读取球员多年薪资;seasonSalaryInfos 与 seasonSalaryHeads 一一对应。
|
|
15
|
+
- 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
|
|
16
|
+
- 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
|
|
17
|
+
- 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
|
|
18
|
+
- SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
|
|
19
|
+
- 必须根据返回的 code 判断是否成功,若 code 不等于 200,必须使用返回的 message 对用户进行友好提示(如 Toast 或弹窗)。
|
|
20
|
+
|
|
21
|
+
# Parameters
|
|
22
|
+
|
|
23
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
24
|
+
| --- | --- | --- | --- |
|
|
25
|
+
| teamId | string | 是 | 球队唯一 ID,例如 "1901000000501288" |
|
|
26
|
+
| leagueType | string | 是 | 联赛类型:nba 或 cba(大小写均可) |
|
|
27
|
+
|
|
28
|
+
# Returns
|
|
29
|
+
|
|
30
|
+
- Type: `Promise<Response>`
|
|
31
|
+
|
|
32
|
+
### Response Properties
|
|
33
|
+
|
|
34
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
35
|
+
| --- | --- | --- | --- |
|
|
36
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
37
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
38
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
39
|
+
| data.projectId | number | 否 | 项目 ID |
|
|
40
|
+
| data.version | string | 否 | 接口版本号,例如 7.5.60 |
|
|
41
|
+
| data.salaryGeneralViewPlate | array | 否 | 薪资概览板块列表 |
|
|
42
|
+
| data.salaryGeneralViewPlate[].leftTitle | string | 否 | 左侧标题,例如 总薪资、需缴纳奢侈税 |
|
|
43
|
+
| data.salaryGeneralViewPlate[].title | string | 否 | 卡片标题,例如 总薪资、薪资空间、奢侈税 |
|
|
44
|
+
| data.salaryGeneralViewPlate[].value | string | 否 | 卡片主数值,例如 2.421亿、-8747万 |
|
|
45
|
+
| data.salaryGeneralViewPlate[].allianceRankingNum | number | 否 | 联盟排名 |
|
|
46
|
+
| data.salaryGeneralViewPlate[].allianceRankingUrl | string | 否 | 联盟排名跳转链接 |
|
|
47
|
+
| data.salaryGeneralViewPlate[].items | array | 否 | 卡片明细项列表 |
|
|
48
|
+
| data.salaryGeneralViewPlate[].items[].name | string | 否 | 明细名称,例如 阵容占据薪资、工资帽 |
|
|
49
|
+
| data.salaryGeneralViewPlate[].items[].value | string | 否 | 明细数值文案,例如 2.259亿 |
|
|
50
|
+
| data.salaryPlayerTable | object | 否 | 球员多年薪资表 |
|
|
51
|
+
| data.salaryPlayerTable.seasonSalaryHeads | array | 否 | 赛季表头列表,例如 2025-26赛季 |
|
|
52
|
+
| data.salaryPlayerTable.seasonSalaryHeads[] | string | 否 | 数组元素 |
|
|
53
|
+
| data.salaryPlayerTable.items | array | 否 | 球员薪资行列表 |
|
|
54
|
+
| data.salaryPlayerTable.items[].playerName | string | 否 | 球员中文名 |
|
|
55
|
+
| data.salaryPlayerTable.items[].playerId | string | 否 | 球员唯一 ID |
|
|
56
|
+
| data.salaryPlayerTable.items[].playerAvatarUrl | string | 否 | 球员头像 URL |
|
|
57
|
+
| data.salaryPlayerTable.items[].age | string | 否 | 年龄文案,例如 29岁 |
|
|
58
|
+
| data.salaryPlayerTable.items[].signedUsing | string / null | 否 | 签约条款,可能为 null |
|
|
59
|
+
| data.salaryPlayerTable.items[].isOutgoing | boolean / null | 否 | 是否即将离队,可能为 null |
|
|
60
|
+
| data.salaryPlayerTable.items[].seasonSalaryInfos | array | 否 | 按 seasonSalaryHeads 顺序排列的各赛季薪资 |
|
|
61
|
+
| data.salaryPlayerTable.items[].seasonSalaryInfos[].restrictedType | string / null | 否 | 自由球员限制类型,例如 UFA、RFA;无限制时为 null |
|
|
62
|
+
| data.salaryPlayerTable.items[].seasonSalaryInfos[].salaryOption | string / null | 否 | 合同选项说明,例如 球员选项、球队选项、非完全保障;无为 null |
|
|
63
|
+
| data.salaryPlayerTable.items[].seasonSalaryInfos[].seasonSalary | string | 否 | 该赛季薪资文案,例如 4639万;无合同为 "-" |
|
|
64
|
+
| data.lastModifyDate | string | 否 | 最近修改时间文案,例如 2025年11月03日 18:08 |
|
|
65
|
+
| data.lastUpdateDate | string | 否 | 最近更新时间(ISO 字符串) |
|
|
66
|
+
|
|
67
|
+
# Examples
|
|
68
|
+
|
|
69
|
+
```javascript
|
|
70
|
+
window.ShaperAI.request.basketball.teamSalaryInfo({ teamId: "1901000000501288", leagueType: "nba" }).then(res => { if (res.code === 200) { console.log(res.data.salaryGeneralViewPlate, res.data.salaryPlayerTable?.items); } })
|
|
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 页 |
|