创建产品公告。
接口说明
请求说明
创建一条平台公告。调用身份必须映射到系统运维租户中的真实平台用户，并拥有公告管理权限。
priority：公告重要性，支持 URGENT、IMPORTANT、GENERAL。targetTenantIds/targetRoleCodes：仅在对应目标模式为 SPECIFIED 时使用，按 JSON array 传递。effectiveStart/effectiveEnd：带时区的 ISO8601 时间。publishNow：为 true 时创建后立即发布，否则保存为草稿。
调试
您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。您可以在OpenAPI Explorer中直接运行该接口，免去您计算签名的困扰。运行成功后，OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
winnexo:CreateAnnouncement |
create |
*全部资源
|
无 | 无 |
请求语法
POST /openapi/createAnnouncement HTTP/1.1请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| tenantId |
string |
否 |
生效租户 ID。 |
10000 |
| title |
string |
是 |
预约会议标题。 |
系统维护通知 |
| content |
string |
是 |
返回内容 |
系统将于今晚进行维护。 |
| priority |
string |
是 |
优先级，取值： |
GENERAL |
| displayType |
string |
否 |
展示类型以及分组标签。 |
LIST |
| targetTenantMode |
string |
否 |
目标租户范围：ALL、SPECIFIED |
ALL |
| targetTenantIds |
array |
否 |
指定目标租户 ID 列表；targetTenantMode=SPECIFIED 时使用 |
[10000] |
|
integer |
否 |
指定目标租户 ID 列表；targetTenantMode=SPECIFIED 时使用 |
10001 |
|
| targetRoleMode |
string |
否 |
目标角色范围：ALL、SPECIFIED |
ALL |
| targetRoleCodes |
array |
否 |
指定系统角色 code 列表；targetRoleMode=SPECIFIED 时使用 |
["SYSTEM_ADMIN"] |
|
string |
否 |
指定系统角色 code 列表；targetRoleMode=SPECIFIED 时使用 |
SYSTEM_ADMIN |
|
| displayPage |
string |
否 |
展示页面：ALL、FRONTEND、BACKEND |
ALL |
| effectiveStart |
string |
否 |
带时区的 ISO8601 生效开始时间；不传表示立即生效 |
2026-08-20T14:00:00+08:00 |
| effectiveEnd |
string |
否 |
定制有效截止时间 |
2026-08-21T14:00:00+08:00 |
| publishNow |
boolean |
否 |
是否创建后立即发布 |
false |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回结果。 |
||
| code |
string |
错误码。 |
200 |
| message |
string |
提示信息。 |
ok |
| requestId |
string |
请求 ID |
019FF406-1B10-0065-A97D-2D1920C2A03D |
| announcementId |
integer |
公告业务 ID |
1001 |
| status |
string |
退款状态。退款中需要查询确认退款状态。
|
PUBLISHED |
| sourceType |
string |
词典文件来源类型，支持：OSS：OSS 开放存储 ORIGIN：保留之前已经上传的词典 |
PLATFORM |
| publishedAt |
string |
发布时间；草稿为空，ISO8601 格式 |
2026-08-20T14:00:00+08:00 |
| createdBy |
integer |
创建人。 |
10001 |
示例
正常返回示例
JSON格式
{
"code": "200",
"message": "ok",
"requestId": "019FF406-1B10-0065-A97D-2D1920C2A03D",
"announcementId": 1001,
"status": "PUBLISHED",
"sourceType": "PLATFORM",
"publishedAt": "2026-08-20T14:00:00+08:00",
"createdBy": 10001
}