# 讨论模块接口

# 接口调用方式

本接口为主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&amp;fileId=5455480607471714894&amp;createDate=2017-04-07&amp;type=image\">");
res2.put("resourceFlag", "0");
res2.put("issueArea", "Account|5269865115340261356");//发布范围
String result = client.post("bbs" ,res2, String.class);

返回说明

发布成功,会返回OK.

创建人:het
修改人:het