1. 文化建设服务管理(V61update)
- 新闻版块及新闻对象
- 公告版块及公告对象
- 讨论版块及讨论对象(Since:V61)
- 调查版块及调查对象(Since:V61)
- 单位新闻版块列表
- 集团新闻版块列表
- 新闻列表(指定版块)
- 新闻列表(指定单位)
- 新增新闻(Since:V5.6)
- 通过ID获取新闻(Since:V7.0)
- 单位公告版块列表
- 集团公告版块列表
- 公告列表(指定版块)
- 公告列表(指定单位)
- 新增公告(Since:V5.6)
- 通过公告ID获取公告信息(Since:V7.0)
- 通过人员登录名返回,对应人员的公告列表(Since:V7.0)
- 通过人员登录名返回,对应人员的公告总数(Since:V7.0)
- 单位讨论板块列表(Since:V61)
- 集团讨论板块列表(Since:V61)
- 讨论列表(指定板块)(Since:V61)
- 讨论列表(指定单位)(Since:V61)
- 创建讨论(Since:V61)
- 单位调查板块列表(Since:V61)
- 集团调查板块列表(Since:V61)
- 调查列表(指定板块)(Since:V61)
- 调查列表(指定单位)(Since:V61)
- 创建调查(Since:V61)
- 查找返回V3XFile对象(Since:V7.0)
1.1. 新闻版块及新闻对象
1.1.1. 新闻版块对象示例
{
"id" : 8683563961317344194,
"typeName" : "单位新闻",
"usedFlag" : true,
"description" : null,
"auditFlag" : true,
"auditUser" : 0,
"createDate" : 1395637157000,
"createUser" : 0,
"updateDate" : 1395637157000,
"updateUser" : null,
"accountId" : -5254486337235892280,
"spaceType" : 2,
"createUserName" : null,
"managerUserIds" : "",
"managerUserNames" : "",
"writeUserIds" : null,
"writeUserNames" : null,
"auditUserName" : "",
"outterPermit" : false
}
1.1.2. 新闻版块属性说明
参数 | 说明 |
---|---|
id | 新闻版块主键 |
typeName | 新闻版块名称 |
usedFlag | 新闻版块是否使用 |
description | 新闻版块描述 |
auditFlag | 新闻版块是否审核 |
auditUser | 新闻版块审核员ID |
createDate | 新闻版块创建时间 |
createUser | 新闻版块创建人ID |
updateDate | 新闻版块最近更新时间 |
updateUser | 新闻版块最近更新人ID |
accountId | 新闻版块所属单位ID |
spaceType | 新闻版块所在空间类型,3:集团 2:单位 1:部门 |
createUserName | 新闻版块创建人名称 |
managerUserIds | 新闻版块管理员ID,以英文逗号分隔,如:12345,67890 |
managerUserNames | 新闻版块管理员名称,以英文逗号分隔,如:张三,李四 |
writeUserIds | 授权此新闻版块发起新闻权限的人员ID |
writeUserNames | 授权此新闻版块发起新闻权限的人员名称 |
auditUserName | 新闻版块审计管理员名称 |
outterPermit | 新闻版块中新闻是否允许外部人员查看 |
1.1.3. 新闻对象示例
{
"id" : -5885266407559051539,
"title" : "特大新闻",
"publishDepartmentId" : 4367506212596958822,
"brief" : null,
"keywords" : null,
"dataFormat" : "HTML",
"createDate" : 1398158141000,
"createUser" : -8361687019900091749,
"auditDate" : null,
"auditUserId" : null,
"auditAdvice" : null,
"publishDate" : 1398158141000,
"publishUserId" : -8361687019900091749,
"pigeonholeDate" : null,
"pigeonholeUserId" : null,
"pigeonholePath" : null,
"updateDate" : null,
"updateUser" : null,
"readCount" : 0,
"state" : 30,
"deletedFlag" : false,
"typeId" : -7855296760518983182,
"typeName" : "行业新闻",
"createUserName" : "张三",
"attachmentsFlag" : false,
"publishDepartmentName" : "平台架构部",
"imageNews" : false,
"focusNews" : false,
"imageId" : null,
"showPublishUserFlag" : false
}
1.1.4. 新闻属性说明
参数 | 说明 |
---|---|
id | 新闻主键 |
title | 新闻标题 |
publishDepartmentId | 新闻发布部门 |
brief | 新闻摘要 |
keywords | 新闻关键字 |
dataFormat | 新闻正文格式 |
createDate | 新闻创建时间 |
createUser | 新闻创建人ID |
auditDate | 新闻审核时间 |
auditUserId | 新闻审核员ID |
auditAdvice | 新闻审核意见 |
publishDate | 新闻发布时间 |
publishUserId | 新闻发布者ID |
pigeonholeDate | 新闻归档时间 |
pigeonholeUserId | 新闻归档者ID |
pigeonholePath | 新闻归档目录 |
updateDate | 新闻最近更新时间 |
updateUser | 新闻最近更新者 |
readCount | 新闻阅读次数 |
state | 新闻状态,0:草稿;10:已提交未审核;20:已审核未发布;30:已发布未归档;40:审核未通过;100:已归档 |
deletedFlag | 新闻是否删除 |
typeId | 新闻所在版块ID |
typeName | 新闻所在版块名称 |
createUserName | 新闻创建人名称 |
attachmentsFlag | 新闻是否有附件 |
publishDepartmentName | 新闻发布部门名称 |
imageNews | 是否为图片新闻 |
focusNews | 是否为焦点新闻 |
imageId | 新闻图片ID |
showPublishUserFlag | 是否显示新闻发布者 |
1.2. 公告版块及公告对象
1.2.1. 公告版块对象示例
{
"id" : -5312468945559469360,
"accountId" : -5254486337235892280,
"auditFlag" : false,
"auditUser" : 0,
"createDate" : 1395637157000,
"createUser" : 0,
"description" : "",
"spaceType" : 2,
"topCount" : 0,
"typeName" : "人事公告",
"updateDate" : 1397631508000,
"updateUser" : -7437328440410879447,
"usedFlag" : true,
"managerUserIds" : "-8361687019900091749",
"sortNum" : 0
}
1.2.2. 公告版块属性说明
参数 | 说明 |
---|---|
id | 公告版块主键 |
accountId | 公告版块所属单位ID |
auditFlag | 公告版块是否审核 |
auditUser | 公告版块审核员ID |
createDate | 公告版块创建时间 |
createUser | 公告版块创建人ID |
description | 公告版块描述 |
spaceType | 公告版块所在空间类型,3:集团 2:单位 1:部门 |
topCount | 公告版块允许公告最大置顶数 |
typeName | 公告版块名称 |
updateDate | 公告版块最近更新时间 |
updateUser | 公告版块最近更新人员 |
usedFlag | 公告版块是否使用 |
managerUserIds | 公告版块管理员ID,以英文逗号分隔,如:12345,67890 |
sortNum | 公告版块排序号 |
1.2.3. 公告对象示例
{
"id" : -8482438586517405384,
"title" : "我的公告",
"publishScope" : "Department|4367506212596958822",
"publishDepartmentId" : 4367506212596958822,
"brief" : "",
"keywords" : "",
"dataFormat" : "HTML",
"createDate" : 1397631709000,
"createUser" : -8361687019900091749,
"auditDate" : null,
"auditUserId" : null,
"auditAdvice" : null,
"publishDate" : 1397631709000,
"publishUserId" : -8361687019900091749,
"pigeonholeDate" : null,
"pigeonholeUserId" : null,
"pigeonholePath" : null,
"updateDate" : 1397631709000,
"updateUser" : -8361687019900091749,
"readCount" : 0,
"topOrder" : 0,
"state" : 30,
"deletedFlag" : false,
"accountId" : -5254486337235892280,
"typeId" : -5312468945559469360,
"typeName" : "人事公告",
"attachmentsFlag" : false,
"publishMemberName" : "张三",
"publishDeptName" : "平台架构部",
"showPublishUserFlag" : false
}
1.2.4. 公告属性说明
参数 | 说明 |
---|---|
id | 公告主键 |
title | 公告标题 |
publishScope | 公告发布范围 |
publishDepartmentId | 公告发布部门 |
brief | 公告摘要 |
keywords | 公告关键字 |
dataFormat | 公告正文格式 |
createDate | 公告创建时间 |
createUser | 公告创建人ID |
auditDate | 公告审核时间 |
auditUserId | 公告审核员ID |
auditAdvice | 公告审核意见 |
publishDate | 公告发布时间 |
publishUserId | 公告发布者ID |
pigeonholeDate | 公告归档时间 |
pigeonholeUserId | 公告归档者ID |
pigeonholePath | 公告归档目录 |
updateDate | 公告最近更新时间 |
updateUser | 公告最近更新人员 |
readCount | 公告阅读次数 |
topOrder | 大于0为置顶,没有其他顺序 |
state | 公告状态,0:草稿;10:已提交未审核;20:已审核未发布;30:已发布未归档;40:审核未通过;100:已归档 |
deletedFlag | 公告是否删除 |
typeId | 公告所在版块ID |
typeName | 公告所在版块名称 |
attachmentsFlag | 公告是否有附件 |
publishMemberName | 公告发布人员名称 |
publishDeptName | 公告发布部门名称 |
showPublishUserFlag | 是否显示公告发布人员 |
1.3. 讨论版块及讨论对象(Since:V61)
1.3.1. 讨论版块对象示例
{
"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" : { }
}
1.3.2. 讨论版块属性说明
参数 | 说明 |
---|---|
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 | - |
1.3.3. 讨论对象示例
{
"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" : { }
}
1.3.4. 讨论属性说明
参数 | 说明 |
---|---|
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 | - |
1.4. 调查版块及调查对象(Since:V61)
1.4.1. 调查版块对象示例
{
"id" : -7049823740074835176,
"typeName" : " 测试调查",
"surveyDesc" : "",
"censorDesc" : 1,
"flag" : 0,
"spaceType" : 2,
"accountId" : 5269865115340261356,
"sort" : 999,
"createDate" : 1491532288000,
"authType" : 0,
"inquirySurveytypeextends" : [ {
"id" : -3301430647411948050,
"managerDesc" : 0,
"managerId" : -3941577936688034522,
"surveytypeId" : -7049823740074835176,
"sort" : 0,
"new" : false,
"extraMap" : { }
} ],
"inquiryAuthorities" : null,
"new" : false,
"extraMap" : { }
}
1.4.2. 调查版块属性说明
参数 | 说明 |
---|---|
id | 调查版块主键 |
typeName | 板块名称 |
surveyDesc | 调查描述 |
censorDesc | 审核标识,0-需要审核,1-不需要审核 |
flag | 删除标记,0-正常,1-删除,2-模板 |
spaceType | 调查所属空间类型(1,部门;2,单位;3,集团;4,自定义团队;17,自定义单位;18,自定义集团) |
accountId | 单位ID |
sort | 排序 |
createDate | 创建时间 |
authType | 发起授权类型,0:全部;1:指定范围 |
inquirySurveytypeextends | |
inquiryAuthorities | |
new | |
extraMap | - |
1.4.3. 调查对象示例
{
"inquirySurveybasic" : {
"id" : 3120564525559072332,
"totals" : 5,
"censor" : 8,
"censorId" : 0,
"clickCount" : 0,
"closeDate" : null,
"createrId" : -3941577936688034522,
"issuerId" : -3941577936688034522,
"issueDate" : 1491552325000,
"cryptonym" : 1,
"departmentId" : 5485888616457063756,
"flag" : 0,
"sendDate" : 1491552325000,
"surveyName" : "接口发起调查",
"surveydesc" : "调查描述",
"surveyDescAfter" : "",
"voteCount" : 0,
"checkMind" : null,
"surveyTypeId" : -7049823740074835176,
"attachmentsFlag" : false,
"allowViewResult" : true,
"allowViewResultAhead" : false,
"showVoters" : true,
"surveyDescImg" : null,
"spaceType" : 2,
"accountId" : 5269865115340261356,
"inquiryScopes" : null,
"inquirySubsurveys" : null,
"inquirySubsurveyitems" : null,
"inquirySurveytype" : null,
"inquirySurveydiscusses" : null,
"inquiryVotedefinites" : null,
"new" : false,
"extraMap" : { }
},
"id" : 3120564525559072332,
"createUserImgUrl" : "/seeyon/apps_res/v3xmain/images/personal/pic.gif",
"createUserName" : "李世民",
"createUserId" : -3941577936688034522,
"issueUserImgUrl" : "/seeyon/apps_res/v3xmain/images/personal/pic.gif",
"issueUserName" : "李世民",
"issueUserId" : -3941577936688034522,
"departmentName" : "开发部",
"departmentId" : 5485888616457063756,
"myState" : true,
"myRead" : false,
"per" : "0%",
"surveyName" : "RES接口发起调查",
"surveyTypeId" : -7049823740074835176,
"surveyTypeName" : "NET 测试 讨论",
"surveyState" : "8",
"sendDate" : 1491552325000,
"issueDate" : 1491552325000,
"closeDate" : null,
"dateFormat" : null
}
1.4.4. 调查对象属性说明
参数 | 说明 |
---|---|
id | 调查主键ID |
createUserName | 创建人 |
createUserId | 创建人ID |
issueUserName | 发布人名称 |
issueUserId | 发布者 |
departmentName | 部门名称 |
departmentId | 发布部门ID |
myState | 状态 |
myRead | |
per | 进度 |
surveyName | 调查名称 |
surveyTypeId | 板块ID |
surveyTypeName | 板块名称 |
surveyState | 状态 |
sendDate | 发起时间 |
issueDate | 发布时间 |
closeDate | 关闭时间 |
dateFormat | |
totals | 发布范围总人数 |
censor | 调查状态1-审核未通过,2-审核通过未发布,3-保存待发,4-未审核,5-终止,8-发布,10-归档,-1-发布未开始 |
censorId | 审核员ID |
clickCount | 点击次数 |
cryptonym | 是否匿名,0-实名,1-匿名 |
surveyDescAfter | 后言 |
voteCount | 投票次数 |
attachmentsFlag | 调查附件,0-无附件,1-有附件 |
allowViewResult | 默认为1,0-不允许查看调查结果,1-允许 |
allowViewResultAhead | 默认为1,0-不允许提交前查看调查结果,1-允许 |
showVoters | 管理员是否可查看投票人,0-不可查看,1-可查看 |
1.5. 单位新闻版块列表
获取某一单位下的新闻版块列表。
接口请求说明:
http请求方式:GET
http://ip:port/seeyon/rest/news/newsType/unit/{unitId}
例如:http://127.0.0.1:8088/seeyon/rest/news/newsType/unit/-7855296760518983182
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
unitId | 是 | 单位ID |
返回说明
正常情况下,会返回的是JSON格式新闻板块信息,JSON数据包参考:新闻版块对象示例
参数说明 请参考:新闻版块属性说明
1.6. 集团新闻版块列表
获取集团的新闻版块列表。
接口请求说明:
http请求方式:GET
http://ip:port/seeyon/rest/news/newsType/group
例如:http://127.0.0.1:8088/seeyon/rest/news/newsType/group
参数说明:
根据此URI直接访问即可,无需参数。
正常情况下会返回NewsType对象的JSON格式集合ArrayList,新闻版块不存在返回null。
返回说明
正常情况下,会返回的是JSON格式新闻板块信息,JSON数据包参考:新闻版块对象示例
参数说明 请参考:新闻版块属性说明
1.7. 新闻列表(指定版块)
获取某个版块下的所有新闻。
接口请求说明:
http请求方式:GET
http://ip:port/seeyon/rest/news/newsType/{typeId}?ticket={ticket}
例如:http://127.0.0.1:8088/seeyon/rest/news/newsType/-4845296760518943182?ticket=macx
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
typeId | 是 | 新闻版块ID |
ticket | 是 | SSO成功后获取的身份令牌,由外部系统产生。 |
正常情况下会返回NewsData对象的JSON格式集合ArrayList,新闻不存在返回null
返回说明
正常情况下,会返回的是JSON格式新闻板块信息,JSON数据包参考:新闻对象示例
参数说明 请参考:新闻属性说明
1.8. 新闻列表(指定单位)
获取某个单位下的所有新闻。
接口请求说明:
http请求方式:GET
http://ip:port/seeyon/rest/news/unit/{unitId}?ticket={ticket}&imageOrFocus={imageOrFocus}
例如:http://127.0.0.1:8088/seeyon/rest/news/unit/967547186016371000?ticket=macx&imageOrFocus=2
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
unitId | 是 | 单位ID |
ticket | 是 | SSO成功后获取的身份令牌,由外部系统产生。 |
imageOrFocus | 否 | 新闻类型,0:图片新闻;1:焦点新闻;2:所有新闻。默认为2 |
返回说明
正常情况下,会返回的是JSON格式新闻板块信息,JSON数据包参考:新闻对象示例
参数说明 请参考:新闻属性说明
1.9. 新增新闻(Since:V5.6)
创建新闻【如果要直接发布新闻,请取消栏目审核,同时,本期咱不支持图片新闻】。
接口请求说明:
http请求方式:POST
http://ip:port/seeyon/rest/news/
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
accountId | 是 | 单位ID |
typeId | 是 | 新闻栏目ID |
brief | 是 | 摘要信息 |
imgUrl | 是 | 图片新闻,图片信息【暂不支持】 |
keywords | 是 | 关键字 |
publishDepartmentName | 是 | 发起者部门名称 |
imageNews | 是 | 图片新闻,图片信息【暂不支持】 |
imageId | 是 | 图片新闻,图片信息【暂不支持】 |
senderuser | 是 | 发送新闻人员的登录名。【新闻发起人必须是对应栏目的管理员,拥有发起权限,否则无法发起新闻】 |
content | 是 | 正文信息。 |
contentName | 是 | 赋值""信息。 |
dataFormat | 是 | 正文类型,现阶段只支持HTML 的正文格式,赋值"HTML". |
ext5 | 是 | “”。 |
publishDepartmentId | 是 | 发起人员部门ID,赋值""信息。 |
publishScope | 是 | 接受公告范围,如果是草稿状态:赋值""信息。如果直接发送,赋值例如【"Post|6279300026643924673,Level|-6807464151015665857"】 |
title | 是 | 新闻标题 |
ext3 | 是 | 草稿状态:赋值"null";直接发布:赋值"0" |
state | 是 | 草稿状态:赋值"0";直接发布:赋值"30" |
publishDate | 是 | 发布日期,赋值例如"2015-06-08 17:03:09" |
publishUserId | 是 | 发布人ID赋值"" |
createDate | 是 | 创建日期,赋值例如"2015-06-08 17:03:09" |
ext1 | 是 | 访问记录信息赋值"0" |
ext2 | 是 | 是否允许打印赋值"0 或者1" |
showPublishUserFlag | 是 | 是否显示发布人 赋值"false 或者 true" |
updateDate | 是 | 更新日期,赋值例如"2015-06-08 17:03:09" |
updateUser | 是 | 更新人员ID,赋值"" |
readCount | 是 | 阅读计数,赋值0 |
attachmentsFlag | 是 | 附件标记,暂不支持附件,,赋值"false" |
返回说明
布成功,会返回公告JSON信息,如果发布失败返回-1
返回参数说明
请参考公告列表(指定版块)返回参数说明
1.10. 通过ID获取新闻(Since:V7.0)
通过ID获取新闻
接口请求说明:
http请求方式:POST
http://ip:port/seeyon/rest/news/{newsId}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
newsId | 是 | 新闻ID |
返回说明
查询成功,会返回新闻JSON信息,如果查询失败返回-1
返回参数说明
请参考公告列表(指定版块)返回参数说明
1.11. 单位公告版块列表
获取某一单位下的公告版块列表。
接口请求说明:
http请求方式:GET
http://ip:port/seeyon/rest/bulletin/bulType/unit/{unitId}
例如:http://127.0.0.1:8088/seeyon/rest/bulletin/bulType/unit/1438182393845429500
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
unitId | 是 | 单位ID |
返回说明
正常情况下,会返回的是JSON格式公告板块信息,JSON数据包参考:公告版块对象示例
参数说明 请参考:公告版块属性说明
1.12. 集团公告版块列表
获取集团下的公告版块列表。
接口请求说明:
http请求方式:GET
http://ip:port/seeyon/rest/bulletin/bulType/group
例如:http://127.0.0.1:8088/seeyon/rest/bulletin/bulType/group
参数说明:
根据此URI直接访问即可,无需参数。
返回说明
正常情况下,会返回的是JSON格式公告板块信息,JSON数据包参考:公告版块对象示例
参数说明 请参考:公告版块属性说明
1.13. 公告列表(指定版块)
获取某一公告版块下的所有公告数据。
接口请求说明:
http请求方式:GET
http://ip:port/seeyon/rest/bulletin/bulType/{typeId}?ticket={ticket}
例如:http://127.0.0.1:8088/seeyon/rest/bulletin/bulType/1438182393845429500?ticket=macx
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
typeId | 是 | 新闻版块ID |
ticket | 是 | SSO成功后获取的身份令牌,由外部系统产生。 |
返回说明
正常情况下,会返回的是JSON格式公告信息,JSON数据包参考:公告对象示例
参数说明 请参考:公告属性说明
1.14. 公告列表(指定单位)
获取某一单位下的所有公告数据
接口请求说明:
http请求方式:GET
http://ip:port/seeyon/rest/bulletin/unit/{unitId}?ticket={ticket}
例如:http://127.0.0.1:8088/seeyon/rest/bulletin/unit/967547186016371000?ticket=macx
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
unitId | 是 | 单位ID |
ticket | 是 | SSO成功后获取的身份令牌,由外部系统产生。 |
返回说明
正常情况下,会返回的是JSON格式公告信息,JSON数据包参考:公告对象示例
参数说明 请参考:公告属性说明
1.15. 新增公告(Since:V5.6)
创建公告【如果要直接发布公告,请取消栏目审核】。
接口请求说明:
http请求方式:POST
http://ip:port/seeyon/rest/bulletin/
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
typeId | 是 | 公告栏目ID |
senderuser | 是 | 发送公告人员的登录名。【公告发起人必须是对应栏目的管理员,拥有发起权限,否则无法发起公告】 |
content | 是 | 正文信息。 |
contentName | 是 | 赋值""信息。 |
dataFormat | 是 | 正文类型,现阶段只支持HTML 的正文格式,赋值"html". |
ext5 | 是 | 赋值""信息。 |
publishDepartmentId | 是 | 发起人员部门ID,赋值""信息。 |
publishScope | 是 | 接受公告范围,如果是草稿状态:赋值""信息。如果直接发送,赋值例如【"Post|6279300026643924673,Level|-6807464151015665857"】 |
title | 是 | 公告标题 |
ext3 | 是 | 草稿状态:赋值"null";直接发布:赋值"0" |
state | 是 | 草稿状态:赋值"0";直接发布:赋值"30" |
publishDate | 是 | 发布日期,赋值例如"2015-06-08 17:03:09" |
publishUserId | 是 | 发布人ID赋值"" |
createDate | 是 | 创建日期,赋值例如"2015-06-08 17:03:09" |
ext1 | 是 | 访问记录信息赋值"0" |
ext2 | 是 | 是否允许打印赋值"0 或者1" |
showPublishUserFlag | 是 | 是否显示发布人 赋值"false 或者 true" |
updateDate | 是 | 更新日期,赋值例如"2015-06-08 17:03:09" |
updateUser | 是 | 更新人员ID,赋值"" |
readCount | 是 | 阅读计数,赋值0 |
attachmentsFlag | 是 | 附件标记,暂不支持附件,,赋值"false" |
返回说明
发布成功,会返回公告JSON信息,如果发布失败返回-1.
返回参数说明
请参考公告列表(指定版块)返回参数说明
1.16. 通过公告ID获取公告信息(Since:V7.0)
通过公告ID获取公告信息。
接口请求说明:
http请求方式:GET
http://ip:port/seeyon/rest/bulletin/{bulletinId}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
bulletinId | 是 | 公告ID |
返回说明
查询成功,会返回公告JSON信息,如果查询失败返回-1.
返回参数说明
请参考公告列表(指定版块)返回参数说明
1.17. 通过人员登录名返回,对应人员的公告列表(Since:V7.0)
通过人员登录名返回,对应人员的公告列表。
接口请求说明:
http请求方式:GET
http://ip:port/seeyon/rest/bulletin/user/loginName/{loginName}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
loginName | 是 | 人员登录名称 |
firstNum | 否 | 分页开始页数 |
pageSize | 否 | 分页每页数量 |
返回说明
查询成功,会返回公告JSON信息,如果查询失败返回-1.
返回参数说明
请参考公告列表(指定版块)返回参数说明
1.18. 通过人员登录名返回,对应人员的公告总数(Since:V7.0)
通过人员登录名返回,对应人员的公告总数。
接口请求说明:
http请求方式:GET
http://ip:port/seeyon/rest/bulletin/count/loginName/{loginName}
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
loginName | 是 | 人员登录名称 |
返回说明
查询成功,会返回公告总数信息,如果查询失败返回 1,message:获取人员信息异常.
返回参数说明 | 参数 | 说明 | | ------------------- | ---------------------------------------- | | code | 请求返回信息 0:成功,1:失败 | | dataCount | 请求成功公告总数 | | message | 请求失败,获取人员信息异常! |
1.19. 单位讨论板块列表(Since:V61)
获取单位下的讨论版块列表。
接口请求说明
http请求方式:GET
http://ip:port/seeyon/rest/bbs/bbsType/unit/{unitid}?pageSize=20&pageNo=1
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
unitid | 是 | 单位ID |
返回说明
正常情况下,会返回的是JSON格式讨论板块信息,JSON数据包参考:讨论版块对象示例
参数说明 请参考:讨论版块属性说明
1.20. 集团讨论板块列表(Since:V61)
获取集团下的讨论版块列表。
接口请求说明
http请求方式:GET
http://ip:port/seeyon/rest/bbs/bbsType/group?pageSize=20&pageNo=1
返回说明
正常情况下,会返回的是JSON格式讨论板块信息,JSON数据包参考:讨论版块对象示例
参数说明 请参考:讨论版块属性说明
1.21. 讨论列表(指定板块)(Since:V61)
获取某个版块下的所有讨论信息。
接口请求说明
http请求方式:GET
http://ip:port/seeyon/rest/bbs/bbsType/{boardId}/{loginName}?pageSize=20&pageNo=1
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
boardId | 是 | 板块ID |
loginName | 是 | 人员登录名 |
返回说明
正常情况下,会返回的是JSON格式讨论信息,JSON数据包参考:讨论对象示例
参数说明 请参考:讨论属性说明
1.22. 讨论列表(指定单位)(Since:V61)
获取单位下的所有讨论信息。
接口请求说明
http请求方式:GET
http://ip:port/seeyon/rest/bbs/unit/{unitId}/{loginName}?pageSize=20&pageNo=1
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
unitId | 是 | 单位ID |
loginName | 是 | 人员登录名 |
返回说明
正常情况下,会返回的是JSON格式讨论信息,JSON数据包参考:讨论对象示例
参数说明 请参考:讨论属性说明
1.23. 创建讨论(Since:V61)
创建讨论接口。【注意:如果讨论正文有图片,请先用 上传文件接口上传图片】
接口请求说明
http请求方式:POST
http://ip:port/seeyon/rest/bbs
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.
1.24. 单位调查板块列表(Since:V61)
获取单位下的调查版块列表。
接口请求说明
http请求方式:GET
http://ip:port/seeyon/rest/inquiries/inquiriesType/unit/{unitId}?pageSize=20&pageNo=1
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
unitId | 是 | 单位ID |
返回说明
正常情况下,会返回的是JSON格式调查板块信息,JSON数据包参考:调查版块对象示例
参数说明 请参考:参数说明 请参考
1.25. 集团调查板块列表(Since:V61)
获取集团下的调查版块列表。
接口请求说明
http请求方式:GET
http://ip:port/seeyon/rest/inquiry/inquiriesType/group?pageSize=20&pageNo=1
返回说明
正常情况下,会返回的是JSON格式调查板块信息,JSON数据包参考:调查版块对象示例
参数说明 请参考:参数说明 请参考
1.26. 调查列表(指定板块)(Since:V61)
获取指定调查板块下的调查列表。
接口请求说明
http请求方式:GET
http://ip:port/seeyon/rest/inquiry/inquiriesType/{boardId}/{loginName}?pageSize=20&pageNo=1
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
boardId | 是 | 板块ID |
loginName | 是 | 登录名 |
返回说明
正常情况下,会返回的是JSON格式调查信息,JSON数据包参考:调查对象示例
参数说明 请参考:调查对象属性说明
1.27. 调查列表(指定单位)(Since:V61)
获取指定单位下的调查列表。
接口请求说明
http请求方式:GET
http://ip:port/seeyon/rest/inquiry/unit/{unitId}/{loginName}?pageSize=20&pageNo=1
参数说明:
参数 | 是否必须 | 说明 |
---|---|---|
unitId | 是 | 单位ID |
loginName | 是 | 登录名 |
返回说明
正常情况下,会返回的是JSON格式调查信息,JSON数据包参考:调查对象示例
参数说明 请参考:调查对象属性说明
1.28. 创建调查(Since:V61)
创建调查接口。
接口请求说明
http请求方式:POST
http://ip:port/seeyon/rest/inquiry
DEMO:
Map res = new HashMap();
res.put("createUserId", "-3941577936688034522");//调查发起人
res.put("surveytypeId", "-7049823740074835176");//调查类型 inquiry_surveytype表
res.put("surveyname", "RES接口发起调查");//调查标题
res.put("surveydesc", "调查描述");//调查描述
res.put("cryptonym", "1");//调查是否实名
res.put("allowViewResult", "true");//调查是否允许查看调查结果
res.put("allowViewResultAhead", "false");//调查是否允许提交前看调查结果
res.put("allowAdminViewResult", "true");//调查发起人/版块管理员查看已投票和未投票人
res.put("questionSort", "0,1");//调查问题的个数
res.put("question0Title", "调查题目1");//调查问题0题目
res.put("question0Desc", "单选题目描述");//调查问题0描述
res.put("question0SingleOrMany", "0");//调普问题0的形式
res.put("question0Discuss", "1");//调查问题0讨论
res.put("question0OtherItem", "1");//调查问题0题目列表
res.put("question0Item", "不是,肯定不是");//讨论题目
res.put("question1Title", "调查题目2");//调查问题1题目
res.put("question1Desc", "单选题目2");//调查问题1描述
res.put("question1SingleOrMany", "0");//调普问题1的形式
res.put("question1Discuss", "1");//调查问题1讨论
res.put("question1OtherItem", "1");//调查问题1题目列表
res.put("question1Item", "对,太对了");
res.put("scopeId", "Account|5269865115340261356");//发布范围
String result = client.post("inquiry" ,res, String.class);
返回说明
发布成功,会返回{"state":"0","msg":"新建调查《接口发起调查》成功!"}
1.29. 查找返回V3XFile对象(Since:V7.0)
查找返回V3XFile对象。
接口请求说明
http请求方式:GET
http://ip:port/seeyon/rest/doc/getctpfile/{ctpFileId}
例如:
http://127.0.0.1:8080/seeyon/rest/doc/getctpfile/-7885545461126487774
DEMO:
CTPRestClient client = RestResource.getInstance().resouresClent();
String token = RestResource.getInstance().getToken(client);
client.get("doc/getctpfile/-7885545461126487774",String.class);
返回说明
获取成功,会返回{"code":"0","data":"V3XFile的JSON的Object对象"}