# 讨论模块接口
# 接口调用方式
本接口为主OA Http Rest,允许被异构系统远程调用,调用前需要调用Rest接口文档 (opens new window)获取Restful token身份凭证。
# 讨论相关结构说明
讨论由多个版块组成,版块下有若干讨论,故需要知道“讨论版块”和“讨论”的数据对象结构。
# 讨论版块对象示例
{
"id" : 1022254943283923056,
"description" : "",
"name" : "讨论测试版本",
"topNumber" : 3,
"anonymousFlag" : 0,
"anonymousReplyFlag" : 0,
"affiliateroomFlag" : 2,
"accountId" : 5269865115340261356,
"boardTime" : 1491532319000,
"sort" : 999,
"orderFlag" : 0,
"imageId" : null,
"authType" : 0,
"flag" : 0,
"admins" : [ -3941577936688034522 ],
"generalMember" : [ ],
"issuerList" : [ ],
"notReplyMember" : [ ],
"canNotReplyList" : [ ],
"new" : false,
"extraMap" : { }
}
# 讨论版块属性说明
参数 | 说明 |
---|---|
id | 讨论版块主键 |
description | 板块描述信息 |
name | 板块名称 |
topNumber | 置顶个数 |
anonymousFlag | 匿名讨论控制,0-匿名,1-否 |
anonymousReplyFlag | 讨论版块是否允许匿名回复,0-允许匿名回复,1-否 |
affiliateroomFlag | 所属空间类型1-部门,2-单位,3-集团,4-自定义团队,12-项目,17-自定义单位,18-自定义集团 |
accountId | 单位ID |
boardTime | 创建时间 |
sort | 排序字段 |
orderFlag | 标识讨论板块的回复是顺序显示还是倒序:0-升序,1-降序 |
imageId | 板块封面ID |
authType | 发起授权类型,0:全部;1:指定范围 |
flag | |
admins | 版主ID |
generalMember | |
issuerList | |
notReplyMember | |
canNotReplyList | |
new | |
extraMap | - |
# 讨论对象示例
{
"id" : -2627351465314465097,
"articleName" : "接口发起讨论",
"clickNumber" : 0,
"replyNumber" : 0,
"content" : null,
"department" : null,
"anonymousFlag" : false,
"anonymousReplyFlag" : false,
"eliteFlag" : false,
"issueTime" : 1491548210000,
"modifyTime" : null,
"issueUserId" : -3941577936688034522,
"messageNotifyFlag" : false,
"post" : null,
"resourceFlag" : 0,
"topSequence" : 0,
"state" : 0,
"boardId" : 1022254943283923056,
"identifier" : "00000000000000000000",
"spaceType" : null,
"accountId" : null,
"shareDajia" : false,
"praise" : "",
"praiseSum" : 0,
"replyTime" : null,
"issueArea" : null,
"hasAttachments" : false,
"new" : false,
"extraMap" : { }
}
# 讨论属性说明
参数 | 说明 |
---|---|
id | 讨论主键ID |
articleName | 讨论标题 |
clickNumber | 用户点击 |
replyNumber | 回复数 |
content | 正文内容 |
department | 发布者所在部门 |
anonymousFlag | 匿名标志,0-正常,1-匿名 |
anonymousReplyFlag | 讨论版块是否允许匿名回复,0-不允许,1-允许 |
eliteFlag | 精华标志,0-正常,1-精华 |
issueTime | 发布时间 |
modifyTime | 修改时间 |
issueUserId | 发布者 |
messageNotifyFlag | 消息通知与否,0-不接收,1-接收 |
post | 发布者所在岗位 |
resourceFlag | 来源标志,0-无,1-原,2-转 |
topSequence | 置顶序号 |
state | 0:正常、1:删除 |
boardId | 讨论板块ID |
identifier | 标识 |
spaceType | 讨论所属空间类型((1,部门;2,单位;3,集团;4,自定义团队;17,自定义单位;18,自定义集团 |
accountId | 单位ID |
shareDajia | 讨论分享到大家社区,0-不允许,1-允许 |
praise | 点赞人员ID集合 |
praiseSum | 点赞总数 |
replyTime | 最新回复时间 |
issueArea | |
hasAttachments | |
new | |
extraMap | - |
# 单位讨论板块列表(Since:V61)
获取单位下的讨论版块列表。
接口请求说明
http请求方式:GET
http://ip:port/seeyon/rest/bbs/bbsType/unit/{unitid}?pageSize=20&pageNo=1
注:请求需要携带token,否则无法使用,获取并传递token方法参考:https://open.seeyoncloud.com/seeyonapi/781/
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
unitid | 是 | 单位ID |
返回说明
正常情况下,会返回的是JSON格式讨论板块信息,JSON数据包参考:讨论版块对象示例
参数说明 请参考:讨论版块属性说明
# 集团讨论板块列表(Since:V61)
获取集团下的讨论版块列表。
接口请求说明
http请求方式:GET
http://ip:port/seeyon/rest/bbs/bbsType/group?pageSize=20&pageNo=1
注:请求需要携带token,否则无法使用,获取并传递token方法参考:https://open.seeyoncloud.com/seeyonapi/781/
返回说明
正常情况下,会返回的是JSON格式讨论板块信息,JSON数据包参考:讨论版块对象示例
参数说明 请参考:讨论版块属性说明
# 讨论列表(指定板块)(Since:V61)
获取某个版块下某个人能看到的所有讨论信息。
接口请求说明
http请求方式:GET
http://ip:port/seeyon/rest/bbs/bbsType/{boardId}/{loginName}?pageSize=20&pageNo=1
注:请求需要携带token,否则无法使用,获取并传递token方法参考:https://open.seeyoncloud.com/seeyonapi/781/
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
boardId | 是 | 板块ID |
loginName | 是 | 用户的OA登录名,或使用SSO单点登录认证提取的ticket,可以尝试用该集团/单位讨论管理员帐号获取最大权限 |
返回说明
正常情况下,会返回的是JSON格式讨论信息,JSON数据包参考:讨论对象示例
参数说明 请参考:讨论属性说明
# 讨论列表(指定单位)(Since:V61)
获取某个单位下某个人能看到的所有讨论信息。
接口请求说明
http请求方式:GET
http://ip:port/seeyon/rest/bbs/unit/{unitId}/{loginName}?pageSize=20&pageNo=1
注:请求需要携带token,否则无法使用,获取并传递token方法参考:https://open.seeyoncloud.com/seeyonapi/781/
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
unitId | 是 | 单位ID |
loginName | 是 | 用户的OA登录名,或使用SSO单点登录认证提取的ticket,可以尝试用该集团/单位讨论管理员帐号获取最大权限 |
返回说明
正常情况下,会返回的是JSON格式讨论信息,JSON数据包参考:讨论对象示例
参数说明 请参考:讨论属性说明
# 创建讨论(Since:V61)
创建讨论接口。
接口请求说明
http请求方式:POST
http://ip:port/seeyon/rest/bbs
注:请求需要携带token,否则无法使用,获取并传递token方法参考:https://open.seeyoncloud.com/seeyonapi/781/
DEMO:
Map res2 = new HashMap();
res2.put("memberId", "-3941577936688034522");//发起人ID
res2.put("boardId", "1022254943283923056");//板块id bbs_board表ID
res2.put("custom", "");//
res2.put("spaceId", "");//
res2.put("DEPARTMENTAffiliateroomFlag", "");
res2.put("articleName", "REST接口发起讨论");//讨论题目
res2.put("content", "<p>正文内容</p><img style=\"width: 1436px; height: 723px;\" alt=\"\" src=\"/seeyon/fileUpload.do?method=showRTE&fileId=5455480607471714894&createDate=2017-04-07&type=image\">");
res2.put("resourceFlag", "0");
res2.put("issueArea", "Account|5269865115340261356");//发布范围
String result = client.post("bbs" ,res2, String.class);
返回说明
发布成功,会返回OK.
创建人:het
修改人:het