/api/restful/?/forumdisplay 接口问题、建议

qiang19900427

以下所有问题是“游客”模式

帖子调用问题

比如我在APP首页想调用最新的帖子，不区分板块，好像我没找到对应的接口。只有，/api/restful/?/forumdisplay 接口，这个接口必须得传板块fid

因该是有个接口筛选各种参数这种，因该是这样哈？

/api/restful/?/forumdisplay 接口

（1）接口好像没有翻页参数

（2）接口好像不能设置显示多少条，我在后台“后台 > 界面 > 主题列表 > 每页显示主题数”这里设置，好像对接口不起作用

（3）接口好像没有调用出回复，如果想做一些类似微信朋友圈那种，在列表显示部分回复的话貌似没法做。

（4）针对发帖人的信息有点少貌似，比如发帖人所属的用户组，所属用户组的组头衔、头衔颜色等等，实际上通过用户id去调用api/restful/?/profile把json二次加入到列表中貌似也行，不过好像这个接口也是数据不全

（5）实现的参数太少啦，比如我想只调用主题分类为2的帖子，只调用今天发布的帖子（我看返回的字段有这个字段），等等，参考如下参数：

qiang19900427

附上这个接口返回的字段如下：

1. /api/restful /?/forumdisplay
   
2. "foruminfo":{
   
3.   "fid": "7", // 版块ID (Forum ID)，唯一标识一个版块
   
4.   "description": "", // 版块描述/简介，通常显示在版块列表中
   
5.   "icon": "", // 版块图标，可以是图片URL或CSS类名
   
6.   "redirect": "", // 重定向URL，如果设置，访问此版块会跳转到该URL（常用于链接到外部网站）
   
7.   "attachextensions": "", // 允许上传的附件扩展名列表，空表示使用全局设置
   
8.   "creditspolicy": [], // 积分策略，定义在该版块发帖、回帖等操作获得的积分，空数组表示使用全局策略
   
9.   "formulaperm": "a:6:{i:0;s:0:"";i:1;s:0:"";s:7:"message";s:0:"";s:5:"medal";N;s:5:"users";s:0:"";s:8:"viewtype";s:1:"0";}", // 用户权限公式（序列化PHP数组），用于设置复杂访问/发帖权限（如积分、用户组、发帖数要求等）
   
10.   "moderators": "", // 版主列表，存储版主用户名（逗号分隔），空表示无版主
    
11.   "rules": "", // 版块规则，可输入HTML，展示在版块页面
    
12.   "threadtypes": [], // 主题分类，定义该版块下可用的主题分类（如“求助”、“分享”等）
    
13.   "threadsorts": [], // 分类信息，定义该版块下可用的详细分类信息模板（如发布商品、活动时的表单）
    
14.   "viewperm": "", // 浏览权限，指定哪些用户组可以浏览此版块，空表示继承上级或全局设置
    
15.   "postperm": "", // 发新主题权限
    
16.   "replyperm": "", // 回复主题权限
    
17.   "getattachperm": "", // 下载附件权限
    
18.   "postattachperm": "", // 发布附件权限
    
19.   "postimageperm": "", // 发布图片权限
    
20.   "spviewperm": "", // 特殊浏览权限（可能用于特定功能）
    
21.   "seotitle": "", // SEO标题，覆盖默认标题，用于搜索引擎优化
    
22.   "keywords": "", // SEO关键词
    
23.   "seodescription": "", // SEO描述
    
24.   "supe_pushsetting": "", // 旧版集成设置（如与UCHome集成），现多为空
    
25.   "modrecommend": { // 版主推荐设置
    
26.     "open": "0", // 是否开启版主推荐，0=关闭
    
27.     "num": 10, // 推荐主题显示数量
    
28.     "imagenum": 0, // 推荐主题中显示图片的数量
    
29.     "imagewidth": 300, // 推荐图片宽度
    
30.     "imageheight": 250, // 推荐图片高度
    
31.     "maxlength": 0, // 推荐理由最大长度
    
32.     "cachelife": 0, // 缓存生命周期（秒）
    
33.     "dateline": 0 // 最后更新时间戳
    
34.   },
    
35.   "threadplugin": [], // 使用的主题插件列表
    
36.   "replybg": "", // 回帖背景图片
    
37.   "extra": { // 额外设置
    
38.     "namecolor": "", // 版主用户名显示颜色
    
39.     "iconwidth": "" // 版块图标宽度
    
40.   },
    
41.   "jointype": "0", // 加入方式，0=自由加入，1=需要申请，2=邀请加入（主要用于群组）
    
42.   "gviewperm": "0", // 群组浏览权限级别
    
43.   "membernum": "0", // 成员数量（主要用于群组）
    
44.   "dateline": "0", // 创建时间戳
    
45.   "lastupdate": "0", // 最后更新时间戳
    
46.   "activity": "0", // 活跃度（可能用于群组）
    
47.   "founderuid": "0", // 创建者用户ID（主要用于群组）
    
48.   "foundername": "", // 创建者用户名
    
49.   "banner": null, // 横幅广告图片
    
50.   "groupnum": "0", // 群组数量（可能用于分类）
    
51.   "commentitem": "", // 评论项设置
    
52.   "relatedgroup": "", // 相关群组ID
    
53.   "picstyle": "0", // 图片样式，0=列表，1=图片（以图片形式展示主题）
    
54.   "widthauto": "0", // 宽度自适应，0=否，1=是
    
55.   "noantitheft": "0", // 禁用防盗链，0=启用防盗链，1=禁用
    
56.   "noforumhidewater": "0", // 禁用版块内隐藏内容的水印，0=启用，1=禁用
    
57.   "noforumrecommend": "0", // 禁用版块推荐，0=启用，1=禁用
    
58.   "livetid": "0", // 直播主题ID，关联一个主题用于直播
    
59.   "price": "0", // 加入群组的费用
    
60.   "fup": "6", // 上级版块ID (Parent Forum ID)，标识此版块属于哪个父版块。7的上级是6。
    
61.   "type": "forum", // 类型，"forum"=论坛版块，"sub"=子版块，"group"=群组，"category"=分类
    
62.   "name": "闲聊扯淡", // 版块名称
    
63.   "status": "1", // 状态，1=启用/开放，0=禁用/关闭
    
64.   "displayorder": "0", // 显示顺序，数值越小越靠前，负数通常用于置顶分类
    
65.   "styleid": "0", // 使用的样式ID，0表示使用默认或上级样式
    
66.   "threads": "5", // 主题总数
    
67.   "posts": "5", // 帖子总数（包含主题和回复）
    
68.   "todayposts": "0", // 今日发帖数
    
69.   "yesterdayposts": "0", // 昨日发帖数
    
70.   "rank": "4", // 排名/等级，用于排序
    
71.   "oldrank": "4", // 旧排名
    
72.   "lastpost": "5\t嘻嘻嘻哈哈哈哈哈哈哈嘻嘻嘻哈哈哈哈哈哈哈\t1755938730\tadmin", // 最后发帖信息（制表符分隔的字符串）
    
73.   "domain": "", // 绑定的二级域名
    
74.   "allowsmilies": "1", // 是否允许使用表情，1=是
    
75.   "allowhtml": "0", // 是否允许使用HTML代码，0=否（出于安全考虑通常关闭）
    
76.   "allowbbcode": "1", // 是否允许使用BBCode，1=是
    
77.   "allowimgcode": "1", // 是否允许使用[img]代码，1=是
    
78.   "allowmediacode": "1", // 是否允许使用[media]代码（嵌入音视频），1=是
    
79.   "allowanonymous": "0", // 是否允许匿名发帖，0=否
    
80.   "allowpostspecial": "1", // 是否允许发布特殊主题（投票、悬赏等），1=是
    
81.   "allowspecialonly": "0", // 是否只允许发布特殊主题，0=否
    
82.   "allowappend": "0", // 是否允许追加回复，0=否
    
83.   "alloweditrules": "0", // 是否允许编辑版块规则，0=否
    
84.   "allowfeed": "0", // 是否允许产生动态（Feed），0=否
    
85.   "allowside": "0", // 是否允许侧边栏，0=否
    
86.   "recyclebin": "1", // 是否启用回收站，1=是
    
87.   "modnewposts": "0", // 新帖审核，0=不需要，1=需要版主审核
    
88.   "jammer": "0", // 打码机，1=开启（对新用户发帖内容打码/屏蔽）
    
89.   "disablewatermark": "0", // 禁用图片水印，0=启用，1=禁用
    
90.   "inheritedmod": "0", // 继承版主，1=是
    
91.   "autoclose": "0", // 自动关闭主题，0=不启用，>0表示天数
    
92.   "forumcolumns": "0", // 版块显示列数
    
93.   "catforumcolumns": "0", // 分类下版块显示列数
    
94.   "threadcaches": "0", // 主题缓存数量
    
95.   "alloweditpost": "1", // 是否允许编辑自己的帖子，1=是
    
96.   "simple": "0", // 简化模式，0=否
    
97.   "modworks": "0", // 版主工作量统计，0=关闭
    
98.   "allowglobalstick": "1", // 允许全局置顶，1=是
    
99.   "level": "0", // 版块级别
    
100.   "commoncredits": "0", // 通用积分
     
101.   "archive": "0", // 是否归档，1=是（内容只读）
     
102.   "recommend": "0", // 推荐指数
     
103.   "favtimes": "0", // 被收藏次数
     
104.   "sharetimes": "0", // 被分享次数
     
105.   "disablethumb": "0", // 禁用缩略图，0=启用，1=禁用
     
106.   "disablecollect": "0", // 禁用收藏，0=启用，1=禁用
     
107.   "ismoderator": 0, // 当前用户是否是该版块的版主（运行时动态生成）
     
108.   "allowpostattach": "" // 发帖时允许上传附件（权限设置，空表示继承）
     
109. },
     
110. "threadlist": [
     
111.     {
     
112.         "tid": "3", // 主题ID (Thread ID)，唯一标识一个主题帖
     
113.         "fid": "7", // 论坛版块ID (Forum ID)，标识该主题属于哪个版块
     
114.         "posttableid": "0", // 帖子数据表ID，用于分表存储帖子内容，0通常表示主表
     
115.         "typeid": "0", // 分类ID (Type ID)，如果版块启用了主题分类，此值对应分类
     
116.         "sortid": "0", // 商品ID (Sort ID)，用于分类信息主题，此处为0表示非分类信息
     
117.         "readperm": "0", // 阅读权限，需要多少权限等级才能阅读此主题，0表示无特殊限制
     
118.         "price": "0", // 售价，主题设置的售价（积分），0表示免费
     
119.         "author": "xiaopingguo", // 发帖作者用户名
     
120.         "authorid": "2", // 发帖作者用户ID
     
121.         "subject": "11测试啦啦啦啦", // 主题标题
     
122.         "dateline": "6 天前", // 发帖时间（人性化显示），原始时间戳在 dbdateline
     
123.         "lastpost": "6 天前", // 最后回复时间（人性化显示），原始时间戳在 dblastpost
     
124.         "lastposter": "xiaopingguo", // 最后回复者用户名
     
125.         "views": "1", // 查看次数/浏览量
     
126.         "replies": "0", // 回复数量
     
127.         "displayorder": "0", // 显示顺序，用于置顶（-1, -2, -3）或正常显示（0）
     
128.         "highlight": "", // 高亮设置，包含颜色和样式代码，空字符串表示无高亮
     
129.         "digest": "0", // 精华等级，0表示非精华，1/2/3表示不同等级的精华帖
     
130.         "rate": "0", // 评分相关，具体含义可能因版本而异，通常与主题评分有关
     
131.         "special": "0", // 特殊主题类型，0=普通主题，1=投票，2=商品，3=悬赏，4=活动，5=辩论
     
132.         "attachment": "0", // 附件标识，0=无附件，1=有附件
     
133.         "moderated": "0", // 是否被版主处理过，0=否，1=是
     
134.         "closed": "0", // 是否关闭，0=开放，1=关闭（禁止回复）
     
135.         "stickreply": "0", // 是否有置顶回复，0=无，1=有
     
136.         "recommends": "0", // 主题推荐数（被推荐的次数）
     
137.         "recommend_add": "0", // 推荐增加数
     
138.         "recommend_sub": "0", // 推荐减少数
     
139.         "heats": "0", // 热度值，用于计算主题热度
     
140.         "status": "0", // 状态位，多位组合，存储多种状态信息（如是否需要审核等）
     
141.         "isgroup": "0", // 是否为群组主题，0=否，1=是
     
142.         "favtimes": "0", // 被收藏次数
     
143.         "sharetimes": "0", // 被分享次数
     
144.         "stamp": "-1", // 主题图章，-1=无图章，0-7对应不同的图章图片
     
145.         "icon": "-1", // 主题图标，-1=无图标，0-7对应不同的图标图片
     
146.         "pushedaid": "0", // 推送到门户文章的ID，0表示未推送
     
147.         "cover": "0", // 封面图片ID，用于门户等，0表示无封面
     
148.         "replycredit": "0", // 回帖奖励积分，0表示无奖励
     
149.         "relatebytag": "0", // 是否通过标签关联，0=否
     
150.         "maxposition": "1", // 最大回复位置，即当前主题下的回复总数（包括主题帖本身）
     
151.         "bgcolor": "", // 背景颜色，为主题设置背景色，空字符串表示无
     
152.         "comments": "0", // 评论数（可能指独立评论模块的评论）
     
153.         "hidden": false, // 是否隐藏（可能用于特定权限或条件）
     
154.         "allreplies": 0, // 所有回复数（可能与 replies 字段类似或有特定计算）
     
155.         "ordertype": 0, // 帖子排序类型，0=倒序（最新在后），1=正序（最新在前）
     
156.         "forumstick": false, // 是否为版块置顶帖
     
157.         "related_group": 0, // 相关群组ID
     
158.         "lastposterenc": "xiaopingguo", // 最后回复者用户名（已编码，通常用于URL或防注入）
     
159.         "typehtml": "", // 分类信息相关的HTML代码，空表示无
     
160.         "typename": "", // 分类名称，空表示无分类
     
161.         "sorthtml": "", // 分类信息HTML代码
     
162.         "multipage": "", // 多页显示的HTML代码（如 [1] [2] [3]），主题帖通常为空
     
163.         "recommendicon": "", // 推荐图标相关的HTML
     
164.         "new": 0, // 是否为新帖标识（通常用于标记用户未读的帖子）
     
165.         "heatlevel": 0, // 热度等级，根据热度值计算出的等级
     
166.         "moved": 0, // 是否被移动过，0=否
     
167.         "folder": "common", // 文件夹类型，"common" 表示普通主题，"new" 可能表示新主题等
     
168.         "weeknew": true, // 是否为本周新帖
     
169.         "icontid": "3", // 图标主题ID，通常与 tid 相同，用于标识使用图标的主题
     
170.         "istoday": 0, // 是否为今天发布的帖子，0=否，1=是
     
171.         "dbdateline": "1755933321", // 发帖时间戳（Unix Timestamp），精确的原始时间数据
     
172.         "dblastpost": "1755933321", // 最后回复时间戳（Unix Timestamp），精确的原始时间数据
     
173.         "id": "normalthread_3", // HTML元素ID，用于前端DOM操作，格式通常是 "类型_主题ID"
     
174.         "mobile": "0", // 是否为手机端发布，0=否，1=是
     
175.         "rushreply": 0, // 是否为抢楼帖，0=否
     
176.         "message": "的就撒开了带我去**** 本内容被作者隐藏 ****就立刻发的就撒开了飞机", // 主题内容/正文
     
177.         "authoravatar": "./data/avatar/noavatar.svg" // 作者头像的URL路径，noavatar.svg 表示默认头像
     
178.     }
     
179. ]

复制代码

monkeye

参数没有的地方见文档的 “_REQUEST” 的说明。

但是说回来了，官方做接口再好，也满足不了所有人，X5 接口的意义就是“开放”
你完全可以做一个自己的接口，写个插件，甚至卖钱

qiang19900427

monkeye 发表于 2025-8-29 12:49
参数没有的地方见文档的 “_REQUEST” 的说明。

但是说回来了，官方做接口再好，也满足不了所有人，X5 接 ...

OK，谢谢老大。