找回密码
 立即注册
搜索
查看: 6973|回复: 15

[插件开发] 论坛模块插件

[复制链接]
发表于 2022-4-17 20:17:04 | 显示全部楼层 |阅读模式

马上注册,结交更多好友,享用更多功能,让你轻松玩转社区

您需要 登录 才可以下载或查看,没有账号?立即注册

×
插 件 简 介

本插件在新秀网络验证插件框架环境下开发,本插件无缝整合Discuz内置系统,采用独立式插件开发、分离代码、支持二次扩展。本插件所有功能实现及控制均采用api接口操作,数据输出形式为JSON、XML两种常见形式,达到毫秒级数据快速交换功能。客户端支持Python、Java、C++、易语言、PHP、易安卓、火山移动等所有主流开发语言,适用于各种pc、app、web端功能开发。

功能简介:获取论坛版块列表、主题、帖子、回复以及发布主题、帖子等功能。

插件授权:点击购买

安装方式:

1、下载 新秀网络验证管理系统新秀网络验证应用中心 插件,并都安装成功;

2、在网站后台插件“新秀网络验证应用中心”中“应用中心”页面点击对应插件安装。

其他相关:开发交流  =  BUG反馈  =   QQ客服:3188639  QQ交流群:281079920

使 用 指 南

1、使用帮助:

暂无

2、后台设置:

暂无

论 坛 模 块

1、获取主题回复   /*获取主题回复列表*/

2、获取版块主题   /*获取版块主题列表*/

3、获取版块列表   /*获取版块列表*/

4、获取版块扩展信息   /*获取版块扩展信息*/

5、回复主题   /*回复主题*/

6、发布主题   /*发布主题,内置主题分类、图标、图章功能*/

7、修改主题帖内容   /*利用主题帖tid,修改主题帖内容,即首贴内容。*/

8、修改回复帖内容   /*利用回复帖子pid,修改帖子回复内容*/

9、获取个人用户主题帖列表   /* 获取用户个人主题帖列表,默认返回5条数据。*/

10、获取个人用户回复帖列表   /*获取用户个人方回复帖列表,默认返回5条数据。*/

11、获取帖子附件列表 /*获取帖子附件列表,如已购买则显示下载地址。*/

12、查询附件购买记录   /*通过附件aid查询此附件,全部购买记录以及用户购买记录。*/

13、购买附件接口 /*通过附件aid购买或查询附件接口。*/

14、查询用户附件收益   /* 通过附件aid查询此附件用户收益。*/

15、查询个人附件列表   /* 查询个人附件列表。*/


更 新 日 志

论坛模块插件ver1.01

修复:获取主题列表、获取回复列表、获取帖子附件列表接口的排序bug;

增强:获取主题列表、获取回复列表,增加返回帖子分类主题id参数;

增强:发布主题接口,支持【Discuz!代码

增强:发布主题接口,发帖后自动增加版块主题数、个人主题数

增强:回复主题接口,支持【Discuz!代码

增强:回复主题接口,发帖后自动增加板块主题数、个人主题数;

修复:获取主题列表、获取回复列表接口中回收站帖子重复获取BUG;

修复:个人获取主题列表,排序bug;

修复:个人获取回帖列表,排序bug;

论坛模块插件ver1.00

修改:获取主题回复、获取板块主题、获取板块列表、获取板块扩展信息,四个接口修改为key参数,取消token验证

增加:获取板块、主题、帖子列表功能

增加:发布、回复主题功能

增加:修改主题、回帖功能

增加:获取附件列表功能

增加:查询附件列表功能

增加:插件设置参数采用文本缓存

待续……

回复

使用道具 举报

 楼主| 发表于 2022-4-17 23:32:45 | 显示全部楼层
获取主题回复
接口说明: 获取主题回复列表

接口详情
请求地址:http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum
请求方式: GET   
返回格式: JSON\XML     /*默认返回JSON格式,如需返回XML格式,请在接口网址后面增加&output=xml参数*/

请求参数(所有参数值均URL加密后传输【注意GBK与UTF8编码区别】
参数类型是否必含说明示例
key[string]传输密钥123456
token[string]token令牌(填写此参数,帖子内已购附件会显示)1487rJ3_xinxiu_jVyxdJsrWhblH4bmJ_xinxiu_gVq
FiP5RE0rPDjjh6vbTTi_xin_xiu_A3MtXSE4bfzIw0XVnDE
action[string]接口方法forum_by_tid
tid[string]主题帖子tid6
start[string]起始数据编号,默认0,可为空0
limit[string]返回数量,默认10条,可为空5
sort[string]排序(DESC为降序、ASC升序)DESC

请求示例(GET)
[PHP] 纯文本查看 复制代码
http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum&key={传输密钥}&token={token令牌}&action=forum_by_tid&tid=6&start=0&limit=5


返回参数所有接口返回数据含中文时“\u672c\u6846”,请用USC2进行解码
参数类型是否必含说明示例
code[number]http状态码200
result[string]错误信息状态码OK
count[number]数组成员数5
data[array]数组
data>>pid[string]帖子id7
data>>fid[string]版块id2
data>>tid[string]主题tid6
data>>typeid[string]主题分类id0
data>>authorid[string]作者uid1
data>>subject[string]标题
data>>message[string]回复内容回复1
data>>dateline[string]回复时间1550927409
data>>position[string]楼层(主题是1,第一个回帖是2,第二个回帖是3,以此类推)2
data>>counts[string]搜索结果总条数5
sqltime[string]页面执行时间(秒)0.00688s

返回示例(JSON)
  1. {
  2.         "code": 200,
  3.         "result": "OK",
  4.         "count": 5,
  5.         "data": [{
  6.                 "pid": "12",
  7.                 "fid": "2",
  8.                 "tid": "7",
  9.                 "authorid": "1",
  10.                 "subject": "\u6d4b\u8bd5\u53d1\u5e16",
  11.                 "message": "\u6d4b\u8bd5\u53d1\u5e16\u7684\u5185\u5bb9\u0000\u0000\u0000",
  12.                 "dateline": "1550932108",
  13.                 "position": "1"
  14.         }, {
  15.                 "pid": "0",
  16.                 "fid": "2",
  17.                 "tid": "7",
  18.                 "authorid": "1",
  19.                 "subject": "",
  20.                 "message": "\u6d4b\u8bd5\u56de\u5e16\u5185\u5bb9",
  21.                 "dateline": "1550932704",
  22.                 "position": "2"
  23.         }, {
  24.                 "pid": "13",
  25.                 "fid": "2",
  26.                 "tid": "7",
  27.                 "authorid": "1",
  28.                 "subject": "",
  29.                 "message": "\u6d4b\u8bd5\u56de\u5e16\u5185\u5bb9",
  30.                 "dateline": "1550968135",
  31.                 "position": "3"
  32.         }, {
  33.                 "pid": "14",
  34.                 "fid": "2",
  35.                 "tid": "7",
  36.                 "authorid": "1",
  37.                 "subject": "",
  38.                 "message": "\u6d4b\u8bd5\u56de\u5e16\u5185\u5bb9",
  39.                 "dateline": "1550968175",
  40.                 "position": "4"
  41.         }, {
  42.                 "pid": "15",
  43.                 "fid": "2",
  44.                 "tid": "7",
  45.                 "authorid": "1",
  46.                 "subject": "",
  47.                 "message": "\u6d4b\u8bd5\u56de\u5e16\u5185\u5bb9",
  48.                 "dateline": "1550968176",
  49.                 "position": "5"
  50.         }],
  51.         "sqltime": "0.0098s"
  52. }
复制代码

额外说明
pre_forum_post 帖子表
字段名
数据类型
默认值
允许非空
自动递增
备注
pid
int(10) unsigned

NO
帖子id
fid
mediumint(8) unsigned
0
NO

论坛id
tid
mediumint(8) unsigned
0
NO

主题id
first
tinyint(1)
0
NO

是否是首贴
author
varchar(15)

NO
作者姓名
authorid
mediumint(8) unsigned
0
NO

作者id
subject
varchar(80)

NO
标题
dateline
int(10) unsigned
0
NO

发表时间
message
mediumtext

NO
消息
useip
varchar(15)

NO
发帖者IP
invisible
tinyint(1)
0
NO

是否通过审核
anonymous
tinyint(1)
0
NO

是否匿名
usesig
tinyint(1)
0
NO

是否启用签名
htmlon
tinyint(1)
0
NO

是否允许HTML
bbcodeoff
tinyint(1)
0
NO

是否关闭BBCODE
smileyoff
tinyint(1)
0
NO

是否关闭表情
parseurloff
tinyint(1)
0
NO

是否允许粘贴URL
attachment
tinyint(1)
0
NO

附件
rate
smallint(6)
0
NO

评分分数
ratetimes
tinyint(3) unsigned
0
NO

评分次数
status
int(10)
0
NO

帖子状态
tags
varchar(255)
0
NO

新增字段,用于存放tag
comment
tinyint(1)
0
NO

是否存在点评
replycredit
int(10)
0
NO

回帖获得积分记录
position
int(8) unsigned

NO
帖子位置信息
pre_forum_thread 主题表
字段名
数据类型
默认值
允许非空
自动递增
备注
tid
mediumint(8) unsigned

NO
主题id
fid
mediumint(8) unsigned
0
NO

上级论坛
posttableid
smallint(6) unsigned
0
NO

帖子表ID
typeid
smallint(6) unsigned
0
NO

主题分类id
sortid
smallint(6) unsigned
0
NO

分类信息id
readperm
tinyint(3) unsigned
0
NO

阅读权限
price
smallint(6)
0
NO

价格
author
char(15)

NO
会员名
authorid
mediumint(8) unsigned
0
NO

会员id
subject
char(80)

NO
标题
dateline
int(10) unsigned
0
NO

发表时间
lastpost
int(10) unsigned
0
NO

最后发表
lastposter
char(15)

NO
最后发表人id
views
int(10) unsigned
0
NO

浏览次数
replies
mediumint(8) unsigned
0
NO

回复次数
displayorder
tinyint(1)
0
NO

显示顺序
highlight
tinyint(1)
0
NO

是否高亮
digest
tinyint(1)
0
NO

是否精华
rate
tinyint(1)
0
NO

是否评分
special
tinyint(1)
0
NO

特殊主题,1:投票;2:商品;3:悬赏;4:活动;5:辩论贴;127:插件相关
attachment
tinyint(1)
0
NO

附件,0无附件 1普通附件 2有图片附件
moderated
tinyint(1)
0
NO

是否被管理员改动
closed
mediumint(8) unsigned
0
NO

是否关闭
stickreply
tinyint(1) unsigned
0
NO

是否有回帖置顶
recommends
smallint(6)
0
NO

推荐指数
recommend_add
smallint(6)
0
NO

支持人数
recommend_sub
smallint(6)
0
NO

反对人数
heats
int(10) unsigned
0
NO

主题热度值
status
smallint(6) unsigned
0
NO

isgroup
tinyint(1)
0
NO

是否为群组帖子
favtimes
mediumint(8)
0
NO

主题收藏次数
sharetimes
mediumint(8)
0
NO

主题分享次数
stamp
tinyint(3)
-1
NO

主题图章
icon
tinyint(3)
-1
NO

主题图标
pushedaid
mediumint(8)
0
NO

被推送到的文章aid
cover
smallint(6)
0
NO

主题封面 负数:远程 正数:本地 0:无封面
replycredit
smallint(6)
0
NO

回帖奖励积分主题记录积分值
relatebytag
char(255)
0
NO

根据帖子标签取的相关主题id (time /t tid,...)
maxposition
int(8) unsigned
0
NO

最大回帖位置信息
bgcolor
char(8)

NO
保存高亮背景色
comments
int(10) unsigned
0
NO

点评数

错误提示码
错误码查询地址:点击访问
BUG提交:点击提交
QQ交流群:281079920
回复

使用道具 举报

 楼主| 发表于 2022-4-17 23:35:14 | 显示全部楼层
获取版块主题
接口说明: 获取版块主题列表

接口详情
请求地址:http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum
请求方式: GET   
返回格式: JSON\XML     /*默认返回JSON格式,如需返回XML格式,请在接口网址后面增加&output=xml参数*/

请求参数(所有参数值均URL加密后传输【注意GBK与UTF8编码区别】
参数类型是否必含说明示例
key[string]传输密钥
action[string]接口方法forum_by_fid
fid[string]版块fid2
start[string]起始数据编号,默认0,可为空0
limit[string]返回数量,默认10条,可为空5
sort[string]排序(DESC为降序、ASC升序)DESC

请求示例(GET)
  1. http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum&key={传输密钥}&action=forum_by_fid&fid=2&start=0&limit=5
复制代码

返回参数所有接口返回数据含中文时“\u672c\u6846”,请用USC2进行解码
参数类型是否必含说明示例
code[number]http状态码200
result[string]错误信息状态码OK
count[number]数组成员数5
data[array]数组
data>>pid[string]帖子id1
data>>fid[string]版块id2
data>>tid[string]主题id1
data>>typeid[string]主题分类id0
data>>authorid[string]作者uid2
data>>author[string]作者用户名mixingz.biz
data>>subject[string]帖子标题测试
data>>message[string]帖子内容测试内容
data>>dateline[string]发帖时间1548511408
data>>recommend_add[string]支持人数
data>>recommend_sub[string]反对人数
data>>image[boolean]主题封面false
data>>attachment[string]主题附件
data>>counts[string]搜索结果总条数5
sqltime[string]页面执行时间(秒)0.01313s

返回示例(JSON)
  1. {
  2.         "code": 200,
  3.         "result": "OK",
  4.         "count": 1,
  5.         "data": [{
  6.                 "pid": "1",
  7.                 "fid": "2",
  8.                 "tid": "1",
  9.                 "authorid": "2",
  10.                 "author": "mixingz.biz",
  11.                 "subject": "测试",
  12.                 "message": "测试内容",
  13.                 "dateline": "1548511408",
  14.                 "recommend_add": "0",
  15.                 "recommend_sub": "0",
  16.                 "image": false
  17.         }],
  18.         "sqltime": "0.01313s"
  19. }
复制代码

额外说明
pre_forum_post 帖子表
字段名
数据类型
默认值
允许非空
自动递增
备注
pid
int(10) unsigned

NO
帖子id
fid
mediumint(8) unsigned
0
NO

论坛id
tid
mediumint(8) unsigned
0
NO

主题id
first
tinyint(1)
0
NO

是否是首贴
author
varchar(15)

NO
作者姓名
authorid
mediumint(8) unsigned
0
NO

作者id
subject
varchar(80)

NO
标题
dateline
int(10) unsigned
0
NO

发表时间
message
mediumtext

NO
消息
useip
varchar(15)

NO
发帖者IP
invisible
tinyint(1)
0
NO

是否通过审核
anonymous
tinyint(1)
0
NO

是否匿名
usesig
tinyint(1)
0
NO

是否启用签名
htmlon
tinyint(1)
0
NO

是否允许HTML
bbcodeoff
tinyint(1)
0
NO

是否关闭BBCODE
smileyoff
tinyint(1)
0
NO

是否关闭表情
parseurloff
tinyint(1)
0
NO

是否允许粘贴URL
attachment
tinyint(1)
0
NO

附件
rate
smallint(6)
0
NO

评分分数
ratetimes
tinyint(3) unsigned
0
NO

评分次数
status
int(10)
0
NO

帖子状态
tags
varchar(255)
0
NO

新增字段,用于存放tag
comment
tinyint(1)
0
NO

是否存在点评
replycredit
int(10)
0
NO

回帖获得积分记录
position
int(8) unsigned

NO
帖子位置信息
pre_forum_thread 主题表
字段名
数据类型
默认值
允许非空
自动递增
备注
tid
mediumint(8) unsigned

NO
主题id
fid
mediumint(8) unsigned
0
NO

上级论坛
posttableid
smallint(6) unsigned
0
NO

帖子表ID
typeid
smallint(6) unsigned
0
NO

主题分类id
sortid
smallint(6) unsigned
0
NO

分类信息id
readperm
tinyint(3) unsigned
0
NO

阅读权限
price
smallint(6)
0
NO

价格
author
char(15)

NO
会员名
authorid
mediumint(8) unsigned
0
NO

会员id
subject
char(80)

NO
标题
dateline
int(10) unsigned
0
NO

发表时间
lastpost
int(10) unsigned
0
NO

最后发表
lastposter
char(15)

NO
最后发表人id
views
int(10) unsigned
0
NO

浏览次数
replies
mediumint(8) unsigned
0
NO

回复次数
displayorder
tinyint(1)
0
NO

显示顺序
highlight
tinyint(1)
0
NO

是否高亮
digest
tinyint(1)
0
NO

是否精华
rate
tinyint(1)
0
NO

是否评分
special
tinyint(1)
0
NO

特殊主题,1:投票;2:商品;3:悬赏;4:活动;5:辩论贴;127:插件相关
attachment
tinyint(1)
0
NO

附件,0无附件 1普通附件 2有图片附件
moderated
tinyint(1)
0
NO

是否被管理员改动
closed
mediumint(8) unsigned
0
NO

是否关闭
stickreply
tinyint(1) unsigned
0
NO

是否有回帖置顶
recommends
smallint(6)
0
NO

推荐指数
recommend_add
smallint(6)
0
NO

支持人数
recommend_sub
smallint(6)
0
NO

反对人数
heats
int(10) unsigned
0
NO

主题热度值
status
smallint(6) unsigned
0
NO

isgroup
tinyint(1)
0
NO

是否为群组帖子
favtimes
mediumint(8)
0
NO

主题收藏次数
sharetimes
mediumint(8)
0
NO

主题分享次数
stamp
tinyint(3)
-1
NO

主题图章
icon
tinyint(3)
-1
NO

主题图标
pushedaid
mediumint(8)
0
NO

被推送到的文章aid
cover
smallint(6)
0
NO

主题封面 负数:远程 正数:本地 0:无封面
replycredit
smallint(6)
0
NO

回帖奖励积分主题记录积分值
relatebytag
char(255)
0
NO

根据帖子标签取的相关主题id (time /t tid,...)
maxposition
int(8) unsigned
0
NO

最大回帖位置信息
bgcolor
char(8)

NO
保存高亮背景色
comments
int(10) unsigned
0
NO

点评数

错误提示码
错误码查询地址:点击访问
BUG提交:点击提交
QQ交流群:281079920
回复

使用道具 举报

 楼主| 发表于 2022-4-17 23:36:21 | 显示全部楼层
获取版块列表
接口说明: 获取版块列表

接口详情
请求地址:http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum
请求方式: GET   
返回格式: JSON\XML     /*默认返回JSON格式,如需返回XML格式,请在接口网址后面增加&output=xml参数*/

请求参数(所有参数值均URL加密后传输【注意GBK与UTF8编码区别】
参数类型是否必含说明示例
key[string]传输密钥123456
action[string]接口方法forum_list

请求示例(GET)
  1. http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum&key={传输密钥}&action=forum_list
复制代码

返回参数所有接口返回数据含中文时“\u672c\u6846”,请用USC2进行解码
参数类型是否必含说明示例
code[number]http状态码200
result[string]错误信息状态码OK
count[number]数组成员数2
data[array]数组
data>>fid[string]论坛版块id1
data>>*[string]返回数据包具体查看下方字段对照表
sqltime[string]页面执行时间(秒)0.00599s
返回示例(JSON)
[PHP] 纯文本查看 复制代码
{
    "code": 200,
    "result": "OK",
    "count": 1,
    "data": [
        {
            "fid": "2",
            "fup": "1",
            "type": "forum",
            "name": "默认版块",
            "status": "1",
            "displayorder": "0",
            "styleid": "0",
            "threads": "7",
            "posts": "37",
            "todayposts": "1",
            "yesterdayposts": "2",
            "rank": "1",
            "oldrank": "1",
            "lastpost": "8\t测试\t1650594896\tadmin",
            "domain": "",
            "allowsmilies": "1",
            "allowhtml": "1",
            "allowbbcode": "1",
            "allowimgcode": "1",
            "allowmediacode": "1",
            "allowanonymous": "0",
            "allowpostspecial": "31",
            "allowspecialonly": "0",
            "allowappend": "0",
            "alloweditrules": "0",
            "allowfeed": "1",
            "allowside": "0",
            "recyclebin": "1",
            "modnewposts": "0",
            "jammer": "0",
            "disablewatermark": "0",
            "inheritedmod": "0",
            "autoclose": "0",
            "forumcolumns": "0",
            "catforumcolumns": "0",
            "threadcaches": "0",
            "alloweditpost": "1",
            "simple": "0",
            "modworks": "0",
            "allowglobalstick": "1",
            "level": "0",
            "commoncredits": "0",
            "archive": "0",
            "recommend": "0",
            "favtimes": "0",
            "sharetimes": "0",
            "disablethumb": "0",
            "disablecollect": "0"
        }
    ],
    "sqltime": "0.00449s"
}
额外说明
字段名
数据类型
默认值
允许非空
自动递增
备注
fid
mediumint(8) unsigned

NO
论坛id
fup
mediumint(8) unsigned
0
NO

上级论坛id
type
enum('group','forum','sub')
forum
NO

类型 (group:分类 forum:普通论坛 sub:子论坛)
name
char(50)

NO

名称
status
tinyint(1)
0
NO

显示状态 (0:隐藏 1:正常 3:群组)
displayorder
smallint(6)
0
NO

显示顺序
styleid
smallint(6) unsigned
0
NO

风格id
threads
mediumint(8) unsigned
0
NO

主题数量
posts
mediumint(8) unsigned
0
NO

帖子数量
todayposts
mediumint(8) unsigned
0
NO

今日发帖数量
yesterdayposts
mediumint(8) unsigned
0
NO

昨日发帖数量
rank
smallint(6) unsigned
0
NO

排名
oldrank
smallint(6) unsigned
0
NO

前天排名
lastpost
char(110)

NO

最后发表
domain
char(15)

NO

绑定的二级域名
allowsmilies
tinyint(1)
0
NO

允许使用表情
allowhtml
tinyint(1)
0
NO

允许使用html
allowbbcode
tinyint(1)
0
NO

允许bbcode
allowimgcode
tinyint(1)
0
NO

允许img
allowmediacode
tinyint(1)
0
NO

允许使用多媒体代码
allowanonymous
tinyint(1)
0
NO

允许匿名
allowpostspecial
smallint(6) unsigned
0
NO

允许发表特殊主题
allowspecialonly
tinyint(1) unsigned
0
NO

只允许发表特殊主题
allowappend
tinyint(1) unsigned
0
NO

是否开启帖子补充
alloweditrules
tinyint(1)
0
NO

允许版主修改论坛规则
allowfeed
tinyint(1)
1
NO

允许推送动态,默认推送广播
allowside
tinyint(1)
0
NO

显示边栏
recyclebin
tinyint(1)
0
NO

是否启用回收站
modnewposts
tinyint(1)
0
NO

是否审核发帖
jammer
tinyint(1)
0
NO

是否启用干扰码
disablewatermark
tinyint(1)
0
NO

是否图片附件增加水印
inheritedmod
tinyint(1)
0
NO

本论坛或分类版主的权力继承到下级论坛
autoclose
smallint(6)
0
NO

自动关闭主题
forumcolumns
tinyint(3) unsigned
0
NO

增加论坛水平横排设置
catforumcolumns
tinyint(3) unsigned
0
NO

增加分区版块水平横排设置
threadcaches
tinyint(1)
0
NO

主题缓存功能设置
alloweditpost
tinyint(1) unsigned
1
NO

允许编辑帖子
simple
tinyint(1) unsigned
0
NO

只显示子版块
modworks
tinyint(1) unsigned
0
NO

本版有待处理的管理事项
allowglobalstick
tinyint(1)
1
NO

是否显示全局置顶
level
smallint(6)
0
NO

群组等级
commoncredits
int(10) unsigned
0
NO

群组公共积分
archive
tinyint(1)
0
NO

是否有存档表
recommend
smallint(6) unsigned
0
NO

推荐到的版块
favtimes
mediumint(8) unsigned
0
NO

版块或群组的收藏次数
sharetimes
mediumint(8) unsigned
0
NO

版块或群组的分享次数
disablethumb
tinyint(1)
0
NO

是否添加缩略图
disablecollect
tinyint(1)
0
NO

禁止淘帖

错误提示码
错误码查询地址:点击访问
BUG提交:点击提交
QQ交流群:281079920
回复

使用道具 举报

 楼主| 发表于 2022-4-17 23:38:54 | 显示全部楼层
获取版块扩展信息
接口说明: 获取指定版块扩展信息

接口详情
请求地址:http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum
请求方式: GET   
返回格式: JSON\XML     /*默认返回JSON格式,如需返回XML格式,请在接口网址后面增加&output=xml参数*/

请求参数(所有参数值均URL加密后传输【注意GBK与UTF8编码区别】
参数类型是否必含说明示例
key[string]传输密钥123456
action[string]接口方法forum_list_fid
fid[string]论坛fid2

请求示例(GET)
  1. http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum&key=(传输密钥)&action=forum_list_fid&fid=2
复制代码

返回参数所有接口返回数据含中文时“\u672c\u6846”,请用USC2进行解码
参数类型是否必含说明示例
code[number]http状态码200
result[string]错误信息状态码OK
count[number]数组成员数5
data[object]数组
data>>fid[string]论坛版块fid2
data>>*[string]返回数据包 具体查看下方字段对照表
sqltime[string]页面执行时间(秒)0.0625s

返回示例(JSON)
[PHP] 纯文本查看 复制代码
{
    "code": 200,
    "result": "OK",
    "count": 46,
    "data": {
        "fid": "2",
        "description": "",
        "password": "",
        "icon": "",
        "redirect": "",
        "attachextensions": "",
        "creditspolicy": "a:0:{}",
        "formulaperm": "a:5:{i:0;s:0:\"\";i:1;s:0:\"\";s:7:\"message\";s:0:\"\";s:5:\"medal\";N;s:5:\"users\";s:0:\"\";}",
        "moderators": "",
        "rules": "修改板块规则开小灶了",
        "threadtypes": "a:6:{s:8:\"required\";b:0;s:8:\"listable\";b:0;s:6:\"prefix\";s:1:\"0\";s:5:\"types\";a:1:{i:1;s:12:\"测试分类\";}s:5:\"icons\";a:1:{i:1;s:0:\"\";}s:10:\"moderators\";a:1:{i:1;N;}}",
        "threadsorts": "",
        "viewperm": "",
        "postperm": "",
        "replyperm": "",
        "getattachperm": "",
        "postattachperm": "",
        "postimageperm": "",
        "spviewperm": "",
        "seotitle": "",
        "keywords": "",
        "seodescription": "",
        "supe_pushsetting": "",
        "modrecommend": "a:8:{s:4:\"open\";s:1:\"0\";s:3:\"num\";i:10;s:8:\"imagenum\";i:0;s:10:\"imagewidth\";i:300;s:11:\"imageheight\";i:250;s:9:\"maxlength\";i:0;s:9:\"cachelife\";i:0;s:8:\"dateline\";i:0;}",
        "threadplugin": "N;",
        "replybg": "",
        "extra": "a:2:{s:9:\"namecolor\";s:0:\"\";s:9:\"iconwidth\";s:0:\"\";}",
        "jointype": "0",
        "gviewperm": "0",
        "membernum": "0",
        "dateline": "0",
        "lastupdate": "0",
        "activity": "0",
        "founderuid": "0",
        "foundername": "",
        "banner": "",
        "groupnum": "0",
        "commentitem": "",
        "relatedgroup": "",
        "picstyle": "0",
        "widthauto": "0",
        "noantitheft": "0",
        "noforumhidewater": "0",
        "noforumrecommend": "0",
        "livetid": "0",
        "price": "0"
    },
    "sqltime": "0.00464s"
}

额外说明
字段名
数据类型
默认值
允许非空
自动递增
备注
fid
mediumint(8) unsigned
0
NO

版块id
description
text

NO
解释说明
password
varchar(12)

NO
私密论坛密码
icon
varchar(255)

NO
图标
redirect
varchar(255)

NO
URL转发
attachextensions
varchar(255)

NO
允许上传附件类型
creditspolicy
mediumtext

NO
版块积分策略
formulaperm
text

NO
版块权限表达式
moderators
text

NO
版主列表,格式:admin
rules
text

NO
版块规则
threadtypes
text

NO
主题分类,序列化存放的设置,格式为一个数组
threadsorts
text

NO
分类信息,序列化存放的设置,格式为一个数组
viewperm
text

NO
阅读权限, 格式: 1 4 5
postperm
text

NO
发表权限, 格式: 1 4 5
replyperm
text

NO
回复权限, 格式: 1 4 5
getattachperm
text

NO
下载附件权限, 格式: 1 4 5
postattachperm
text

NO
上传附件权限, 格式: 1 4 5
postimageperm
text

NO
上传图片权限, 格式: 1 4 5
spviewperm
text

NO
不受限于版权权限表达式, 格式: 1 4 5
seotitle
text

NO
版块seo标题
keywords
text

NO
版块seo关键词
seodescription
text

NO
版块seo描述
supe_pushsetting
text

NO
supe推送设置,序列化存放设置数据,格式为一个数组。
modrecommend
text

NO
版主推荐规则
threadplugin
text

NO
特殊主题插件数据
replybg
text

NO
回复框背景
extra
text

NO
jointype
tinyint(1)
0
NO

加入群组方式 -1为关闭,0为公开, 2邀请
gviewperm
tinyint(1) unsigned
0
NO

群组浏览权限 0:仅成员 1:所有用户
membernum
smallint(6) unsigned
0
NO

群组成员数
dateline
int(10) unsigned
0
NO

群组创建时间
lastupdate
int(10) unsigned
0
NO

群组最后更新时间
activity
int(10) unsigned
0
NO

群组活跃度
founderuid
mediumint(8) unsigned
0
NO

群组创始人UID
foundername
varchar(255)

NO
群组创始人名称
banner
varchar(255)

NO
群组头图片
groupnum
smallint(6) unsigned
0
NO

分类下的群组数量
commentitem
text

NO
relatedgroup
text

NO
picstyle
tinyint(1)
0
NO

帖子列表是否以图片形式显示 0:否 1:是
widthauto
tinyint(1)
0
NO

默认是否宽屏 0:全局 -1:宽屏 1:窄屏
noantitheft
tinyint(1)
0
NO

禁止防采集
noforumhidewater
tinyint(1)
0
NO

禁止隐藏水帖
noforumrecommend
tinyint(1)
0
NO

禁止推荐回复
livetid
mediumint(8) unsigned
0
NO

版块直播帖tid
price
mediumint(8) unsigned
0
NO

进入版块所需支付的积分

错误提示码
错误码查询地址:点击访问
BUG提交:点击提交
QQ交流群:281079920
回复

使用道具 举报

 楼主| 发表于 2022-4-17 23:40:03 | 显示全部楼层
回复主题
接口说明: 回复主题

接口详情
请求地址:http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum
请求方式: GET   
返回格式: JSON\XML     /*默认返回JSON格式,如需返回XML格式,请在接口网址后面增加&output=xml参数*/

请求参数(所有参数值均URL加密后传输【注意GBK与UTF8编码区别】
参数类型是否必含说明示例
token[string]token令牌1487rJ3_xinxiu_jVyxdJsrWhblH4bmJ_xinxiu_gVqFiP5RE0
rPDjjh6vbTTi_xin_xiu_A3MtXSE4bfzIw0XVnDE
action[string]接口方法forum_post_tid
tid[string]帖子tid7
fid[string]版块fid2
message[string]回复内容测试回帖内容

请求示例(GET)
  1. http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum&token={token令牌}&action=forum_post_tid&tid=7&fid=2&message=测试回帖内
复制代码

返回参数所有接口返回数据含中文时“\u672c\u6846”,请用USC2进行解码
参数类型是否必含说明示例
code[number]http状态码200
result[string]错误信息状态码OK
count[number]数组成员数7
data[object]数组
data>>fid[string]版块fid2
data>>author[string]用户名admin
data>>authorid[string]用户uid1
data>>tid[string]帖子tid7
data>>first[number]回复类型
data>>message[string]回复内容测试回帖内容
data>>dateline[number]回复时间1550932704
sqltime[string]页面执行时间(秒)0.00749s

返回示例(JSON)
  1. {
  2.         "code": 200,
  3.         "result": "OK",
  4.         "count": 7,
  5.         "data": {
  6.                 "fid": "2",
  7.                 "author": "admin",
  8.                 "authorid": "1",
  9.                 "tid": "7",
  10.                 "first": 0,
  11.                 "message": "\u6d4b\u8bd5\u56de\u5e16\u5185\u5bb9",
  12.                 "dateline": 1550932704
  13.         },
  14.         "sqltime": "0.00749s"
  15. }
复制代码

额外说明

错误提示码
错误码查询地址:点击访问
BUG提交:点击提交
QQ交流群:281079920
回复

使用道具 举报

 楼主| 发表于 2022-4-17 23:40:40 | 显示全部楼层
发布主题
接口说明: 发布主题,内置主题分类、图标、图章。

接口详情
请求地址:http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum
请求方式: GET   
返回格式: JSON\XML     /*默认返回JSON格式,如需返回XML格式,请在接口网址后面增加&output=xml参数*/

请求参数(所有参数值均URL加密后传输【注意GBK与UTF8编码区别】
参数类型是否必含说明示例
token[string]token令牌1487rJ3_xinxiu_jVyxdJsrWhblH4bmJ_xinxiu_g
VqFiP5RE0rPDjjh6vbTTi_xin_xiu_A3MtXSE4bfzIw0XVnDE
action[string]接口方法forum_post
fid[string]版块fid2
subject[string]发帖标题测试发帖
message[string]发帖内容测试发帖的内容【支持Discuz!代码】
typeid[string]主题分类2
stamp[string]图章-1
icon[string]图标-1

请求示例(GET)
  1. http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum&token={token令牌}&action=forum_post&fid=2&subject=测试发帖&message=测试发帖的内容&typeid=2&stamp=-1&icon=-1
复制代码

返回参数所有接口返回数据含中文时“\u672c\u6846”,请用USC2进行解码
参数类型是否必含说明示例
code[number]http状态码200
result[string]错误信息状态码OK
count[number]数组成员数6
data[object]数组
data>>fid[string]版块fid2
data>>subject[string]发帖标题测试发帖
data>>message[string]发帖内容测试发帖的内容
data>>authorid[string]用户uid1
data>>author[string]用户名admin
data>>typeid[number]主题分类2
data>>stamp[number]图章-1
data>>icon[number]图标-1
data>>tid[object]帖子id7
sqltime[string]页面执行时间(秒)0.01265s

返回示例(JSON)
  1. {
  2.     "code": 200,
  3.     "result": "OK",
  4.     "count": 9,
  5.     "data": {
  6.         "fid": "2",
  7.         "subject": "测试发帖",
  8.         "message": "测试发帖的内容",
  9.         "authorid": "1",
  10.         "author": "admin",
  11.         "typeid": "3",
  12.         "stamp": "-1",
  13.         "icon": "-1",
  14.         "tid": 60
  15.     },
  16.     "sqltime": "0.03125s"
  17. }
复制代码

额外说明

错误提示码
错误码查询地址:点击访问
BUG提交:点击提交
QQ交流群:281079920
回复

使用道具 举报

 楼主| 发表于 2022-4-17 23:41:16 | 显示全部楼层
修改主题帖内容
接口说明: 利用主题帖tid,修改主题帖内容,即首贴内容。

接口详情
请求地址:http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum
请求方式: GET   
返回格式: JSON\XML     /*默认返回JSON格式,如需返回XML格式,请在接口网址后面增加&output=xml参数*/

请求参数(所有参数值均URL加密后传输【注意GBK与UTF8编码区别】
参数类型是否必含说明示例
token[string]token令牌1487rJ3_xinxiu_jVyxdJsrWhblH4bmJ_xinxiu_gVqFiP5RE0
rPDjjh6vbTTi_xin_xiu_A3MtXSE4bfzIw0XVnDE
action[string]接口方法set_by_tid
tid[string]主题帖tid56
subject[string]主题帖标题为空即不修改标题
message[string]主题帖内容主题帖内容

请求示例(GET)
  1. http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum&token={token令牌}&action=set_by_tid&tid=56&message=修改主题帖内容&subject=修改主题帖标题
复制代码

返回参数所有接口返回数据含中文时“\u672c\u6846”,请用USC2进行解码
参数类型是否必含说明示例
code[number]http状态码200
result[string]错误信息状态码OK
count[number]数组成员数4
data[object]数组
data>>authorid[string]用户uid1
data>>tid[string]主题帖tid56
data>>subject[string]修改主题帖标题修改主题帖标题
data>>message[string]修改主题帖内容修改主题帖内容
sqltime[string]页面执行时间(秒)0.00749s

返回示例(JSON)
  1. {
  2.     "code": 200,
  3.     "result": "OK",
  4.     "count": 4,
  5.     "data": {
  6.         "authorid": "1",
  7.         "tid": "56",
  8.         "subject": "修改主题帖标题",
  9.         "message": "修改主题帖内容"
  10.     },
  11.     "sqltime": "0.00335s"
  12. }
复制代码

额外说明

错误提示码
错误码查询地址:点击访问
BUG提交:点击提交
QQ交流群:281079920
回复

使用道具 举报

 楼主| 发表于 2022-4-17 23:41:57 | 显示全部楼层
修改回复帖内容
接口说明: 利用回复帖子pid,修改帖子回复内容

接口详情
请求地址:http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum
请求方式: GET   
返回格式: JSON\XML     /*默认返回JSON格式,如需返回XML格式,请在接口网址后面增加&output=xml参数*/

请求参数(所有参数值均URL加密后传输【注意GBK与UTF8编码区别】
参数类型是否必含说明示例
token[string]token令牌1487rJ3_xinxiu_jVyxdJsrWhblH4bmJ_xinxiu_gVqFiP5RE0
rPDjjh6vbTTi_xin_xiu_A3MtXSE4bfzIw0XVnDE
action[string]接口方法set_by_pid
pid[string]回复帖子pid103
message[string]回复内容测试回帖内容

请求示例(GET)
  1. http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum&token={token令牌}&action=set_by_pid&pid=103&message=修改最新的内容
复制代码

返回参数所有接口返回数据含中文时“\u672c\u6846”,请用USC2进行解码
参数类型是否必含说明示例
code[number]http状态码200
result[string]错误信息状态码OK
count[number]数组成员数7
data[object]数组
data>>authorid[string]用户uid1
data>>pid[string]帖子pid103
data>>message[string]修改帖子内容修改最新的内容
sqltime[string]页面执行时间(秒)0.00749s

返回示例(JSON)
  1. {
  2.     "code": 200,
  3.     "result": "OK",
  4.     "count": 3,
  5.     "data": {
  6.         "authorid": "1",
  7.         "pid": "103",
  8.         "message": "修改最新的内容"
  9.     },
  10.     "sqltime": "0.00349s"
  11. }
复制代码

额外说明

错误提示码
错误码查询地址:点击访问
BUG提交:点击提交
QQ交流群:281079920
回复

使用道具 举报

 楼主| 发表于 2022-4-17 23:42:45 | 显示全部楼层
获取用户主题帖列表
接口说明: 获取用户个人主题帖列表,默认返回5条数据。

接口详情
请求地址:http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum
请求方式: GET   
返回格式: JSON\XML     /*默认返回JSON格式,如需返回XML格式,请在接口网址后面增加&output=xml参数*/

请求参数(所有参数值均URL加密后传输【注意GBK与UTF8编码区别】
参数类型是否必含说明示例
token[string]token令牌1487rJ3_xinxiu_jVyxdJsrWhblH4bmJ_xinxiu_gVqFiP5RE0
rPDjjh6vbTTi_xin_xiu_A3MtXSE4bfzIw0XVnDE
action[string]接口方法get_by_tid
start[string]起始数据编号,默认0,可为空0
limit[string]返回数量,默认10条,可为空5
sort[string]排序(DESC为降序、ASC升序)DESC

请求示例(GET)
  1. http://demo.xinxiuvip.com/plugin.php?id=xinxiu_network_plugin:forum&token={token令牌}&action=get_by_tid&limit=1
复制代码

返回参数所有接口返回数据含中文时“\u672c\u6846”,请用USC2进行解码
参数类型是否必含说明示例
code[number]http状态码200
result[string]错误信息状态码OK
count[number]数组成员数7
data[object]数组
data>>authorid[string]用户uid1
data>>tid[string]主题帖tid33
data>>pid[string]帖子pid56
data>>fid[string]帖子版块fid2
data>>subject[string]帖子标题这个演示标题
data>>message[string]帖子内容这里是测试首贴内容6
data>>dateline[string]发帖时间1585989717
data>>position[string]所在楼层1
data>>counts[string]搜索结果总条数5
sqltime[string]页面执行时间(秒)0.00749s

返回示例(JSON)
  1. {
  2.     "code": 200,
  3.     "result": "OK",
  4.     "count": 1,
  5.     "data": [
  6.         {
  7.             "pid": "56",
  8.             "fid": "2",
  9.             "tid": "33",
  10.             "authorid": "1",
  11.             "subject": "这个演示标题",
  12.             "message": "这里是测试首贴内容6",
  13.             "dateline": "1585989717",
  14.             "position": "1"
  15.         }
  16.     ],
  17.     "sqltime": "0.00254s"
  18. }
复制代码

额外说明

错误提示码
错误码查询地址:点击访问
BUG提交:点击提交
QQ交流群:281079920
回复

使用道具 举报

您需要登录后才可以回帖 登录 | 立即注册

本版积分规则

QQ|Archiver|手机版|新秀网络验证系统API ( 豫ICP备2021033257号-1 )

GMT+8, 2024-3-29 19:56 , Processed in 0.284643 second(s), 60 queries , Redis On.

Powered by Discuz! X3.5 Licensed

© 2001-2024 Discuz! Team.

快速回复 返回顶部 返回列表