@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,159 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-bbs-get-topic-threads
|
|
3
|
+
description: 查看论坛专区或话题下的最新帖子,用于话题广场与专区内容流。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.bbs.getTopicThreads(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 接口原始信封中的 code/internalCode/msg/success 会由 ShaperAI 标准化为 code/message;业务渲染字段从 res.data 读取。
|
|
13
|
+
- 分页加载结束判定:当返回数据中的 nextPage 字段为 false 时,代表没有更多数据;下一页游标使用 cursor 传给 lastCursor。
|
|
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
|
+
| topic_id | string | 是 | 专区/话题唯一 ID,例如 "85" |
|
|
24
|
+
| tab_type | number | 否 | Tab 类型,如 2 代表最新回复,默认 2 |
|
|
25
|
+
| page | number | 否 | 页码,从 1 开始,默认为 1 |
|
|
26
|
+
| stamp | number | 否 | 时间戳,默认为 0 |
|
|
27
|
+
| lastCursor | string | 否 | 最后一项游标,用于分页 |
|
|
28
|
+
|
|
29
|
+
# Returns
|
|
30
|
+
|
|
31
|
+
- Type: `Promise<Response>`
|
|
32
|
+
|
|
33
|
+
### Response Properties
|
|
34
|
+
|
|
35
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
36
|
+
| --- | --- | --- | --- |
|
|
37
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
38
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
39
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
40
|
+
| data.nextPage | boolean | 否 | 是否还有下一页;false 表示没有更多数据 |
|
|
41
|
+
| data.next_page | number | 否 | 兼容旧分页字段;优先使用 nextPage 判断是否还有更多数据 |
|
|
42
|
+
| data.stamp | number / null | 否 | 分页时间戳/服务端返回的列表标记,可能为 null |
|
|
43
|
+
| data.total | number / null | 否 | 总数,接口可能返回 null |
|
|
44
|
+
| data.list | array | 否 | 帖子列表数据 |
|
|
45
|
+
| data.list[].tid | number | 否 | 帖子唯一 ID |
|
|
46
|
+
| data.list[].title | string | 否 | 帖子标题 |
|
|
47
|
+
| data.list[].summary | string | 否 | 帖子摘要/正文截断内容,可能为空字符串 |
|
|
48
|
+
| data.list[].puid | number | 否 | 发帖人 PUID |
|
|
49
|
+
| data.list[].fid | number | 否 | 论坛版块 ID |
|
|
50
|
+
| data.list[].replies | number | 否 | 回复数 |
|
|
51
|
+
| data.list[].repliesDesc | string / null | 否 | 回复数展示文案,可能为 null |
|
|
52
|
+
| data.list[].userName | string | 否 | 发帖人昵称 |
|
|
53
|
+
| data.list[].userHeader | string | 否 | 发帖人头像 URL |
|
|
54
|
+
| data.list[].time | string | 否 | 帖子展示时间,如 "07-19" |
|
|
55
|
+
| data.list[].createTime | number | 否 | 发帖时间戳 |
|
|
56
|
+
| data.list[].lastPostTime | number | 否 | 最后回复/更新时间戳 |
|
|
57
|
+
| data.list[].recommendCount | number | 否 | 推荐/亮了数量 |
|
|
58
|
+
| data.list[].shareNum | number | 否 | 分享数 |
|
|
59
|
+
| data.list[].topicId | number | 否 | 帖子所属话题/专区 ID |
|
|
60
|
+
| data.list[].topicName | string | 否 | 帖子所属话题/专区名称 |
|
|
61
|
+
| data.list[].topicIcon | string | 否 | 帖子所属话题/专区图标 URL |
|
|
62
|
+
| data.list[].topThread | boolean | 否 | 是否置顶帖 |
|
|
63
|
+
| data.list[].specialIdentifyPics | string / null | 否 | 特殊标识图片 URL,可能为 null |
|
|
64
|
+
| data.list[].nightSpecialIdentifyPics | string / null | 否 | 夜间模式特殊标识图片 URL,可能为 null |
|
|
65
|
+
| data.list[].specialIdentifyPicsWidth | number / null | 否 | 特殊标识图片宽度,可能为 null |
|
|
66
|
+
| data.list[].specialIdentifyPicsHeight | number / null | 否 | 特殊标识图片高度,可能为 null |
|
|
67
|
+
| data.list[].videoThread | boolean | 否 | 是否视频帖 |
|
|
68
|
+
| data.list[].jumpUrl | string | 否 | 帖子跳转 Schema/链接 |
|
|
69
|
+
| data.list[].video | object / null | 否 | 视频信息;非视频帖为 null |
|
|
70
|
+
| data.list[].video.duration | number | 否 | 视频时长,单位秒 |
|
|
71
|
+
| data.list[].video.vid | number | 否 | 视频 ID |
|
|
72
|
+
| data.list[].video.img | string | 否 | 视频封面 URL |
|
|
73
|
+
| data.list[].video.size | number | 否 | 视频大小,单位字节 |
|
|
74
|
+
| data.list[].video.width | number | 否 | 视频宽度 |
|
|
75
|
+
| data.list[].video.play_num | number | 否 | 播放数 |
|
|
76
|
+
| data.list[].video.url | string | 否 | 视频播放 URL |
|
|
77
|
+
| data.list[].video.bullet_comment_num | number | 否 | 弹幕数 |
|
|
78
|
+
| data.list[].video.height | number | 否 | 视频高度 |
|
|
79
|
+
| data.list[].video.humanDuration | string | 否 | 格式化视频时长,如 "4:04" |
|
|
80
|
+
| data.list[].video.humanSize | string | 否 | 格式化视频大小,如 "29MB" |
|
|
81
|
+
| data.list[].picList | array | 否 | 图片列表 |
|
|
82
|
+
| data.list[].picList[].url | string | 否 | 图片 URL |
|
|
83
|
+
| data.list[].picList[].is_gif | number | 否 | 是否 GIF,0 表示否,1 表示是 |
|
|
84
|
+
| data.list[].picList[].width | number | 否 | 图片宽度 |
|
|
85
|
+
| data.list[].picList[].height | number | 否 | 图片高度 |
|
|
86
|
+
| data.list[].picList[].type | string | 否 | 图片类型,如 common |
|
|
87
|
+
| data.list[].picList[].videoUrl | string / null | 否 | 图片关联视频 URL,可能为 null |
|
|
88
|
+
| data.list[].containPic | boolean | 否 | 是否包含图片 |
|
|
89
|
+
| data.list[].lightReplyResult | object / null | 否 | 亮评信息;无亮评时为 null |
|
|
90
|
+
| data.list[].lightReplyResult.lightReplyData | object | 否 | 亮评内容 |
|
|
91
|
+
| data.list[].lightReplyResult.lightReplyData.pid | number | 否 | 亮评回复 ID |
|
|
92
|
+
| data.list[].lightReplyResult.lightReplyData.tid | number | 否 | 亮评所属帖子 ID |
|
|
93
|
+
| data.list[].lightReplyResult.lightReplyData.aid | number / null | 否 | 亮评 aid,可能为 null |
|
|
94
|
+
| data.list[].lightReplyResult.lightReplyData.puid | number | 否 | 亮评用户 PUID |
|
|
95
|
+
| data.list[].lightReplyResult.lightReplyData.username | string | 否 | 亮评用户昵称 |
|
|
96
|
+
| data.list[].lightReplyResult.lightReplyData.user_ip | string | 否 | 亮评用户 IP |
|
|
97
|
+
| data.list[].lightReplyResult.lightReplyData.via | number | 否 | 亮评来源端标识 |
|
|
98
|
+
| data.list[].lightReplyResult.lightReplyData.content | string | 否 | 亮评内容 |
|
|
99
|
+
| data.list[].lightReplyResult.lightReplyData.quote | object / null | 否 | 引用回复信息;无引用时为 null |
|
|
100
|
+
| data.list[].lightReplyResult.lightReplyData.quote.rerferInfo | object | 否 | 被引用用户信息(接口字段名为 rerferInfo) |
|
|
101
|
+
| data.list[].lightReplyResult.lightReplyData.quote.rerferInfo.username | string | 否 | 被引用用户昵称 |
|
|
102
|
+
| data.list[].lightReplyResult.lightReplyData.quote.rerferInfo.puid | number | 否 | 被引用用户 PUID |
|
|
103
|
+
| data.list[].lightReplyResult.lightReplyData.quote.content | string | 否 | 被引用回复内容 |
|
|
104
|
+
| data.list[].lightReplyResult.lightReplyData.quote.togglecontent | string / null | 否 | 折叠/展开内容,可能为 null |
|
|
105
|
+
| data.list[].lightReplyResult.lightReplyData.quote.attr | string | 否 | 引用回复扩展属性序列化字符串 |
|
|
106
|
+
| data.list[].lightReplyResult.lightReplyData.quote.videoInfo | object / null | 否 | 引用回复视频信息,可能为 null |
|
|
107
|
+
| data.list[].lightReplyResult.lightReplyData.quote.ancillaryContents | array / null | 否 | 引用回复附属内容,可能为 null |
|
|
108
|
+
| data.list[].lightReplyResult.lightReplyData.quote.pid | number | 否 | 被引用回复 ID |
|
|
109
|
+
| data.list[].lightReplyResult.lightReplyData.create_time | number | 否 | 亮评创建时间戳 |
|
|
110
|
+
| data.list[].lightReplyResult.lightReplyData.update_info | string | 否 | 亮评更新信息 |
|
|
111
|
+
| data.list[].lightReplyResult.lightReplyData.attr | string | 否 | 亮评扩展属性序列化字符串 |
|
|
112
|
+
| data.list[].lightReplyResult.lightReplyData.score | number | 否 | 亮评分数 |
|
|
113
|
+
| data.list[].lightReplyResult.lightReplyData.checkReplyInfo | object | 否 | 亮评检查/回复状态信息 |
|
|
114
|
+
| data.list[].lightReplyResult.lightReplyData.checkReplyInfo.type | number | 否 | 状态类型 |
|
|
115
|
+
| data.list[].lightReplyResult.lightReplyData.checkReplyInfo.num | number | 否 | 状态数量 |
|
|
116
|
+
| data.list[].lightReplyResult.lightReplyData.light_count | number | 否 | 亮了数量 |
|
|
117
|
+
| data.list[].lightReplyResult.lightReplyData.allLightCount | number | 否 | 总亮了数量 |
|
|
118
|
+
| data.list[].lightReplyResult.lightReplyData.videoInfo | object / null | 否 | 亮评视频信息,可能为 null |
|
|
119
|
+
| data.list[].lightReplyResult.lightReplyData.header | string | 否 | 亮评用户头像 URL |
|
|
120
|
+
| data.list[].lightReplyResult.lightReplyData.header_big | string | 否 | 亮评用户大头像 URL |
|
|
121
|
+
| data.list[].lightReplyResult.lightReplyData.header_small | string | 否 | 亮评用户小头像 URL |
|
|
122
|
+
| data.list[].lightReplyResult.lightReplyData.groupId | number | 否 | 用户组 ID |
|
|
123
|
+
| data.list[].lightReplyResult.lightReplyData.picInfos | array | 否 | 亮评图片信息列表 |
|
|
124
|
+
| data.list[].lightReplyResult.lightReplyData.ancillaryContents | array / null | 否 | 亮评附属内容,可能为 null |
|
|
125
|
+
| data.list[].lightReplyResult.total | number | 否 | 亮评总数 |
|
|
126
|
+
| data.list[].timeFormatter | string / null | 否 | 时间格式化结果,可能为 null |
|
|
127
|
+
| data.list[].contentType | number | 否 | 内容类型 |
|
|
128
|
+
| data.list[].voteThread | boolean | 否 | 是否投票帖 |
|
|
129
|
+
| data.list[].voteIdList | array | 否 | 投票 ID 列表 |
|
|
130
|
+
| data.list[].voteList | array / null | 否 | 投票信息列表,可能为 null |
|
|
131
|
+
| data.list[].showIcon | string / null | 否 | 展示图标 URL,可能为 null |
|
|
132
|
+
| data.list[].showIconNight | string / null | 否 | 夜间模式展示图标 URL,可能为 null |
|
|
133
|
+
| data.list[].certIconUrl | string / null | 否 | 认证图标 URL,可能为 null |
|
|
134
|
+
| data.list[].certTitle | string / null | 否 | 认证标题,可能为 null |
|
|
135
|
+
| data.list[].filterWords | array / null | 否 | 过滤词列表,可能为 null |
|
|
136
|
+
| data.list[].containsPodcast | boolean / null | 否 | 是否包含播客,可能为 null |
|
|
137
|
+
| data.list[].podcastInfo | object / null | 否 | 播客信息,可能为 null |
|
|
138
|
+
| data.list[].isDraw | boolean | 否 | 是否抽奖帖 |
|
|
139
|
+
| data.cursor | string | 否 | 下一页请求游标,加载更多时传给 lastCursor |
|
|
140
|
+
|
|
141
|
+
# Examples
|
|
142
|
+
|
|
143
|
+
```javascript
|
|
144
|
+
window.ShaperAI.request.bbs.getTopicThreads({ topic_id: "85", page: 1 }).then(res => { if (res.code === 200) { console.log(res.data); } })
|
|
145
|
+
```
|
|
146
|
+
|
|
147
|
+
# Frontend Request Guard
|
|
148
|
+
|
|
149
|
+
| 策略 | 默认值 |
|
|
150
|
+
| --- | --- |
|
|
151
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
152
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
153
|
+
| 请求超时 | 8000ms |
|
|
154
|
+
| 单能力最大并发 | 不限制 |
|
|
155
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
156
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
157
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
158
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
159
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,124 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-bbs-gets-thread-post-list
|
|
3
|
+
description: 获取帖子下的评论与回复列表,支持分页和排序,用于评论区展示。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.bbs.getsThreadPostList(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
|
+
| tid | string | 是 | 帖子唯一ID(thread ID),例如 "640720803" |
|
|
23
|
+
| fid | string | 否 | 板块唯一ID(forum ID),例如 "1389" |
|
|
24
|
+
| page | number | 否 | 页码,从 1 开始,默认为 1 |
|
|
25
|
+
| sort | number | 否 | 排序类型,默认为 0 |
|
|
26
|
+
| order | string | 否 | 排序顺序:asc(正序)或 desc(倒序),默认为 "asc" |
|
|
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.list | array | 否 | 回复列表数据 |
|
|
40
|
+
| data.list[].pid | string | 否 | 回复唯一ID |
|
|
41
|
+
| data.list[].puid | string | 否 | 回复用户唯一ID |
|
|
42
|
+
| data.list[].content | string | 否 | 回复内容文本/HTML |
|
|
43
|
+
| data.list[].create_time | string | 否 | 回复创建时间戳(秒) |
|
|
44
|
+
| data.list[].via | string | 否 | 回复来源/客户端标识 |
|
|
45
|
+
| data.list[].attr | object | 否 | 回复属性信息 |
|
|
46
|
+
| data.list[].attr.audit_status | string | 否 | 审核状态 |
|
|
47
|
+
| data.list[].light_count | number | 否 | 亮评/点赞数 |
|
|
48
|
+
| data.list[].allLightCount | number | 否 | 总点亮数 |
|
|
49
|
+
| data.list[].ancillaryContents | object / null | 否 | 附属内容信息,可能为空 |
|
|
50
|
+
| data.list[].quote_light_count | number | 否 | 被引用回复的点亮数 |
|
|
51
|
+
| data.list[].check_reply_info | object | 否 | 查看回复信息 |
|
|
52
|
+
| data.list[].check_reply_info.num | number | 否 | 回复数量 |
|
|
53
|
+
| data.list[].check_reply_info.type | number | 否 | 回复类型 |
|
|
54
|
+
| data.list[].quote | array / null | 否 | 引用回复列表,可能为空 |
|
|
55
|
+
| data.list[].quote[].header | array / null | 否 | 引用头部文案数组 |
|
|
56
|
+
| data.list[].quote[].header[] | string | 否 | 引用头部文案 |
|
|
57
|
+
| data.list[].quote[].content | string | 否 | 引用内容文本/HTML |
|
|
58
|
+
| data.list[].quote[].togglecontent | string / null | 否 | 引用内容折叠态文案 |
|
|
59
|
+
| data.list[].quote[].pid | string / null | 否 | 被引用回复ID |
|
|
60
|
+
| data.list[].quote[].puid | string / null | 否 | 被引用用户唯一ID |
|
|
61
|
+
| data.list[].quote[].attr | object / null | 否 | 被引用回复属性信息 |
|
|
62
|
+
| data.list[].quote[].attr.audit_status | string | 否 | 审核状态 |
|
|
63
|
+
| data.list[].quote[].ancillaryContents | object / null | 否 | 被引用回复附属内容信息,可能为空 |
|
|
64
|
+
| data.list[].quote[].containsAi | number / null | 否 | 被引用回复是否包含 AI 内容,0/1 |
|
|
65
|
+
| data.list[].smallcontent | string | 否 | 回复内容短文案 |
|
|
66
|
+
| data.list[].togglecontent | string | 否 | 回复内容折叠态文案 |
|
|
67
|
+
| data.list[].floor | number | 否 | 楼层数 |
|
|
68
|
+
| data.list[].time | string | 否 | 友好时间显示,如 "5天前" |
|
|
69
|
+
| data.list[].userName | string | 否 | 回复用户昵称 |
|
|
70
|
+
| data.list[].userImg | string | 否 | 回复用户头像链接 |
|
|
71
|
+
| data.list[].quote_deleted | number | 否 | 引用内容是否已删除,0/1 |
|
|
72
|
+
| data.list[].groupid | string / null | 否 | 用户分组 ID,可能为空 |
|
|
73
|
+
| data.list[].certuser | object / null | 否 | 认证用户信息,可能为空 |
|
|
74
|
+
| data.list[].certurl | string / null | 否 | 认证跳转链接,可能为空 |
|
|
75
|
+
| data.list[].cert_info | object / null | 否 | 认证信息,可能为空 |
|
|
76
|
+
| data.list[].cert_url | string / null | 否 | 认证链接,可能为空 |
|
|
77
|
+
| data.list[].viainfo | object / null | 否 | 来源信息,可能为空 |
|
|
78
|
+
| data.list[].badgeOpen | number | 否 | 勋章展示开关,0/1 |
|
|
79
|
+
| data.list[].badgeImgUrl | string / null | 否 | 勋章图片链接,可能为空 |
|
|
80
|
+
| data.list[].selfRecommend | number | 否 | 是否自荐/自推荐,0/1 |
|
|
81
|
+
| data.list[].grantDto | object | 否 | 送礼/赞赏聚合信息 |
|
|
82
|
+
| data.list[].grantDto.detailDtoList | array | 否 | 送礼/赞赏明细列表 |
|
|
83
|
+
| data.list[].grantDto.detailDtoList[] | object | 否 | 送礼/赞赏明细项 |
|
|
84
|
+
| data.list[].grantDto.totalCoins | number | 否 | 累计金币数 |
|
|
85
|
+
| data.list[].grantDto.totalUsers | number | 否 | 累计送礼/赞赏用户数 |
|
|
86
|
+
| data.list[].grantDto.showGiftIconMinCount | number | 否 | 展示礼物图标的最小数量阈值 |
|
|
87
|
+
| data.list[].giftList | array | 否 | 礼物列表 |
|
|
88
|
+
| data.list[].giftList[] | object | 否 | 礼物项 |
|
|
89
|
+
| data.list[].ornament | string / null | 否 | 头像挂件/装饰图片链接,可能为空 |
|
|
90
|
+
| data.list[].badge | string / null | 否 | 勋章图片链接,可能为空 |
|
|
91
|
+
| data.list[].badgeName | string / null | 否 | 勋章名称,可能为空 |
|
|
92
|
+
| data.list[].badgeBgImg | string / null | 否 | 勋章背景图链接,可能为空 |
|
|
93
|
+
| data.list[].badgeForwardUrl | string / null | 否 | 勋章跳转链接,可能为空 |
|
|
94
|
+
| data.list[].adminsInfo | object / null | 否 | 管理员信息,可能为空 |
|
|
95
|
+
| data.list[].location | string | 否 | 回复用户IP属地 |
|
|
96
|
+
| data.list[].nftInfo | object / null | 否 | NFT 信息,可能为空 |
|
|
97
|
+
| data.list[].vipInfo | object / null | 否 | 会员信息,可能为空 |
|
|
98
|
+
| data.list[].containsAi | number | 否 | 回复是否包含 AI 内容,0/1 |
|
|
99
|
+
| data.list[].deepTalkReply | boolean | 否 | 是否深度讨论回复 |
|
|
100
|
+
| data.all_page | number | 否 | 总页数 |
|
|
101
|
+
| data.ad_page_id | string | 否 | 广告页标识 |
|
|
102
|
+
| data.firstReply | object / null | 否 | 首条回复信息,可能为空 |
|
|
103
|
+
| data.issueFirstReplyHCoin | boolean | 否 | 是否发放首评 H 币 |
|
|
104
|
+
| data.extInfo | object / null | 否 | 扩展信息,可能为空 |
|
|
105
|
+
|
|
106
|
+
# Examples
|
|
107
|
+
|
|
108
|
+
```javascript
|
|
109
|
+
window.ShaperAI.request.bbs.getsThreadPostList({ tid: "640720803", page: 1 }).then(res => { if (res.code === 200) { console.log(res.data); } })
|
|
110
|
+
```
|
|
111
|
+
|
|
112
|
+
# Frontend Request Guard
|
|
113
|
+
|
|
114
|
+
| 策略 | 默认值 |
|
|
115
|
+
| --- | --- |
|
|
116
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
117
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
118
|
+
| 请求超时 | 8000ms |
|
|
119
|
+
| 单能力最大并发 | 不限制 |
|
|
120
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
121
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
122
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
123
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
124
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,75 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-bbs-open-post-editor
|
|
3
|
+
description: 从活动页唤起发帖页面,并自动填入标题、正文和图片,方便用户快速参与内容创作。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.bbs.openPostEditor(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 必须通过 window.ShaperAI.request.bbs.openPostEditor(params) 方法唤起发帖,严禁直接手写 location.href 或 Schema
|
|
13
|
+
- topicId、tagId、topicName、tagName 分三种情况:业务明确指定非空值时用该值;业务明确不要设置这四个值时,调用时不要传这四个字段,也不要 await window.ShaperAI.bbsConfig.get() 去补;业务未提及这四个值时,必须先 await window.ShaperAI.bbsConfig.get(),并先判断 bbs.bbsTagId:若无值、null、undefined、空字符串或仅空白,四个字段都不要传入、也不要用页面其它字段兜底;仅当 bbsTagId 为非空字符串时,才把 bbsTopicId、bbsTagId、bbsTopicName、bbsTagName 传入对应参数。不要写死其它专区/话题
|
|
14
|
+
- 若包含图片 imageUrl,建议先使用 oss.uploadFile 上传获得 CDN 地址,再传入发帖参数
|
|
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
|
+
| topicId | string | 否 | 发布的目标专区 ID,可选 (例如 "85")。业务明确指定非空值时用该值;业务明确不要设置时不要传、也不要从页面补;未提及时仅当页面 bbsTagId 为非空字符串才用 bbsConfig.bbsTopicId。 |
|
|
26
|
+
| tagId | string | 否 | 发布的目标话题 ID,可选 (例如 "152660")。业务明确指定非空值时用该值;业务明确不要设置时不要传、也不要从页面补;未提及时仅当页面 bbsTagId 为非空字符串才用 bbsConfig.bbsTagId。 |
|
|
27
|
+
| topicName | string | 否 | 专区名称,可选 (例如 "数码区")。业务明确指定非空值时用该值;业务明确不要设置时不要传、也不要从页面补;未提及时仅当页面 bbsTagId 为非空字符串才用 bbsConfig.bbsTopicName。 |
|
|
28
|
+
| tagName | string | 否 | 话题名称,可选 (例如 "虎扑有奖活动")。业务明确指定非空值时用该值;业务明确不要设置时不要传、也不要从页面补;未提及时仅当页面 bbsTagId 为非空字符串才用 bbsConfig.bbsTagName。 |
|
|
29
|
+
| title | string | 否 | 预填的帖子标题,可选 |
|
|
30
|
+
| content | string / array | 否 | 预填的帖子正文段落,支持普通文本字符串或富文本段落数组(含文本和链接),可选 |
|
|
31
|
+
| imageUrl | string | 否 | 预填的图片 URL 链接,可选 |
|
|
32
|
+
|
|
33
|
+
# Returns
|
|
34
|
+
|
|
35
|
+
- Type: `Promise<Response>`
|
|
36
|
+
|
|
37
|
+
### Response Properties
|
|
38
|
+
|
|
39
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
40
|
+
| --- | --- | --- | --- |
|
|
41
|
+
| code | number | 是 | 状态码,200 表示成功构建并拉起 |
|
|
42
|
+
| message | string | 是 | 说明信息 |
|
|
43
|
+
| schema | string | 是 | 生成的 native schema 协议地址 |
|
|
44
|
+
|
|
45
|
+
# Examples
|
|
46
|
+
|
|
47
|
+
```javascript
|
|
48
|
+
const bbs = await window.ShaperAI.bbsConfig.get(); const params = { title: "测试发帖", content: "这是预填的帖子内容..." }; if (bbs && typeof bbs.bbsTagId === "string" && bbs.bbsTagId.trim() !== "") { params.topicId = bbs.bbsTopicId; params.tagId = bbs.bbsTagId; params.topicName = bbs.bbsTopicName; params.tagName = bbs.bbsTagName; } window.ShaperAI.request.bbs.openPostEditor(params)
|
|
49
|
+
```
|
|
50
|
+
|
|
51
|
+
```javascript
|
|
52
|
+
window.ShaperAI.request.bbs.openPostEditor({ title: "测试发帖", content: "这是预填的帖子内容..." })
|
|
53
|
+
```
|
|
54
|
+
|
|
55
|
+
```javascript
|
|
56
|
+
window.ShaperAI.request.bbs.openPostEditor({ topicId: "85", title: "测试发帖", content: "这是预填的帖子内容..." })
|
|
57
|
+
```
|
|
58
|
+
|
|
59
|
+
```javascript
|
|
60
|
+
window.ShaperAI.request.bbs.openPostEditor({ topicId: "85", title: "图文发帖", content: [{ type: "paragraph", content: [{ type: "text", text: "说不出的我爱你:" }, { type: "link", attrs: { href: "https://bbs.hupu.com", title: "Joyflower 玫瑰" } }] }] })
|
|
61
|
+
```
|
|
62
|
+
|
|
63
|
+
# Frontend Request Guard
|
|
64
|
+
|
|
65
|
+
| 策略 | 默认值 |
|
|
66
|
+
| --- | --- |
|
|
67
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
68
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
69
|
+
| 请求超时 | 8000ms |
|
|
70
|
+
| 单能力最大并发 | 不限制 |
|
|
71
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
72
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
73
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
74
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
75
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,59 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-request-bbs-reply-post
|
|
3
|
+
description: 在 App 内直接回复社区帖子,只需提供目标帖子和回复内容,即可完成回帖互动。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.request.bbs.replyPost(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 必须通过 window.ShaperAI.request.bbs.replyPost({ tid, content }) 调用,且仅支持虎扑 App 环境;禁止直接使用 fetch、axios、XMLHttpRequest、第三方请求库或自行拼接 bridge。
|
|
13
|
+
- 虎扑回帖底层请求方法必须为 POST,严禁使用 GET 发起回帖提交。
|
|
14
|
+
- 回帖接口 URL 默认使用 /1/${version}/bbsreplyapi/reply/v1/app/create;iOS 环境自动改为 /3/${version}/bbsreplyapi/reply/v1/app/create。
|
|
15
|
+
- 回帖接口使用 application/json 请求头和对象 body;Android 原生按 Content-Type 选择 JSON 序列化,iOS 沿用现有 JSON 提交配置。
|
|
16
|
+
- tid 为目标帖子 ID,content 为回帖内容字符串;调用前请先校验内容非空,再根据返回的 code/message 给用户做友好提示。
|
|
17
|
+
- 请求接口数据必须使用 window.ShaperAI.request 能力及其子能力发起,禁止使用 fetch、axios、XMLHttpRequest、第三方请求库或其它自定义请求方式。
|
|
18
|
+
- 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
|
|
19
|
+
- 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
|
|
20
|
+
- SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
|
|
21
|
+
|
|
22
|
+
# Parameters
|
|
23
|
+
|
|
24
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
25
|
+
| --- | --- | --- | --- |
|
|
26
|
+
| tid | string | 是 | 目标帖子 ID,例如 "640720803" |
|
|
27
|
+
| content | string | 是 | 回帖内容字符串,不能为空 |
|
|
28
|
+
|
|
29
|
+
# Returns
|
|
30
|
+
|
|
31
|
+
- Type: `Promise<Response>`
|
|
32
|
+
|
|
33
|
+
### Response Properties
|
|
34
|
+
|
|
35
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
36
|
+
| --- | --- | --- | --- |
|
|
37
|
+
| code | number | 是 | 状态码。200 表示成功,401 表示未登录,404 表示内容不存在,500 表示服务器错误 |
|
|
38
|
+
| message | string | 是 | 错误提示信息。当 code 不等于 200 时必须用于向用户友好提示 |
|
|
39
|
+
| data | object | 否 | 成功时返回的数据载荷 |
|
|
40
|
+
|
|
41
|
+
# Examples
|
|
42
|
+
|
|
43
|
+
```javascript
|
|
44
|
+
window.ShaperAI.request.bbs.replyPost({ tid: "640720803", content: "支持一下,写得很好。" }).then(res => { if (res.code === 200) { console.log(res.data); } })
|
|
45
|
+
```
|
|
46
|
+
|
|
47
|
+
# Frontend Request Guard
|
|
48
|
+
|
|
49
|
+
| 策略 | 默认值 |
|
|
50
|
+
| --- | --- |
|
|
51
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
52
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
53
|
+
| 请求超时 | 8000ms |
|
|
54
|
+
| 单能力最大并发 | 不限制 |
|
|
55
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
56
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
57
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
58
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
59
|
+
| 自动分页建议上限 | 5 页 |
|
|
@@ -0,0 +1,57 @@
|
|
|
1
|
+
---
|
|
2
|
+
name: hupu-score-add-score
|
|
3
|
+
description: 让用户对指定球员、装备等对象进行打分(1-10 分),用于活动页收集用户评价。
|
|
4
|
+
---
|
|
5
|
+
|
|
6
|
+
# Usage
|
|
7
|
+
|
|
8
|
+
- JS Path: `window.ShaperAI.score.addScore(params)`
|
|
9
|
+
|
|
10
|
+
# Constraints
|
|
11
|
+
|
|
12
|
+
- 必须通过 window.ShaperAI.score.addScore(params) 接口,严禁直接手写 POST 接口 URL
|
|
13
|
+
- score 必须是 1 到 10 之间的数值,source 为选填字段
|
|
14
|
+
- 未登录状态下,提交评分可能会返回未登录错误,需做好登录兜底提示
|
|
15
|
+
- 数据能力调用必须避免无条件循环、无限轮询和重复渲染触发;同一参数的返回结果应优先保存在组件状态中复用。
|
|
16
|
+
- 列表/分页类接口连续自动翻页最多 5 页,必须在无下一页、返回空列表或达到页数上限时停止。
|
|
17
|
+
- SDK 前端已启用请求保护:默认不限制单能力并发和分钟调用量,不启用相同请求在途合并或 GET 短缓存;同 URL 在 10000ms 内最多 20 次;同一页面同接口(去掉 query/hash 参数后相同即为同一接口)在 5000ms 内最多 20 次,首次超过限制返回 429,后续同窗口请求静默丢弃,且同一窗口内只上报一次异常日志。不要自行循环重试或重复触发请求,若接口真实返回 408、429 或 503 等错误码,必须停止继续请求并给用户友好提示。
|
|
18
|
+
|
|
19
|
+
# Parameters
|
|
20
|
+
|
|
21
|
+
| 参数名 | 类型 | 是否必填 | 说明 |
|
|
22
|
+
| --- | --- | --- | --- |
|
|
23
|
+
| outBizType | string | 是 | 业务类型。常用可选值包括:nbaPlayer (NBA球员), cbaPlayer (CBA球员), equipment (运动装备), games (游戏), movie (电影影视), food (美食), school (高校) |
|
|
24
|
+
| outBizNo | string | 是 | 业务对象 ID,例如球员 ID |
|
|
25
|
+
| score | number | 是 | 打分分值,范围 1 - 10 之间 |
|
|
26
|
+
| source | string | 否 | 来源渠道标识,可选 |
|
|
27
|
+
|
|
28
|
+
# Returns
|
|
29
|
+
|
|
30
|
+
- Type: `Promise<Response>`
|
|
31
|
+
|
|
32
|
+
### Response Properties
|
|
33
|
+
|
|
34
|
+
| 属性名 | 类型 | 是否必填 | 说明 |
|
|
35
|
+
| --- | --- | --- | --- |
|
|
36
|
+
| success | boolean | 是 | 是否提交成功 |
|
|
37
|
+
| message | string | 否 | 错误信息或成功提示 |
|
|
38
|
+
|
|
39
|
+
# Examples
|
|
40
|
+
|
|
41
|
+
```javascript
|
|
42
|
+
window.ShaperAI.score.addScore({ outBizType: "nbaPlayer", outBizNo: "12345", score: 9.5 })
|
|
43
|
+
```
|
|
44
|
+
|
|
45
|
+
# Frontend Request Guard
|
|
46
|
+
|
|
47
|
+
| 策略 | 默认值 |
|
|
48
|
+
| --- | --- |
|
|
49
|
+
| 同请求在途合并窗口 | 不启用(0ms) |
|
|
50
|
+
| GET 缓存 TTL | 不启用(0ms) |
|
|
51
|
+
| 请求超时 | 8000ms |
|
|
52
|
+
| 单能力最大并发 | 不限制 |
|
|
53
|
+
| 单能力分钟调用上限 | 不限制 |
|
|
54
|
+
| 同 URL 窗口调用上限 | 20 次 / 10000ms(超过限制排队等待) |
|
|
55
|
+
| 同页面同接口窗口调用上限(去掉 query/hash 参数) | 20 次 / 5000ms(首次超过限制返回 429,后续同窗口请求静默丢弃,异常日志只上报一次) |
|
|
56
|
+
| 连续失败熔断 | 3 次失败后熔断 30000ms |
|
|
57
|
+
| 自动分页建议上限 | 5 页 |
|