分页查询公告可见范围
根据公告ID分页查询可见的企业/部门/用户列表
标签:公告管理
请求说明
| 字段 | 值 |
|---|---|
请求地址 | https://openapi.wps.cn/v7/announce/announces/{announce_id}/visibilities |
HTTP 方法 | GET |
接口描述 | 根据公告ID分页查询可见的企业/部门/用户列表 |
签名方式 | KSO-1 |
限频策略 | 无 |
权限要求 | 查询公告(应用授权) kso.announce.read |
请求头 (Headers)
| 属性名 | 类型 | 是否必填 | 描述 | 可选值 |
|---|---|---|---|---|
X-Kso-Id-Type | string | 否 | 类型 * internal - 内部 * external - 外部 | internal, external |
路径参数 (Path)
| 属性名 | 类型 | 是否必填 | 描述 | 可选值 |
|---|---|---|---|---|
announce_id | string | 是 | 公告ID(字符串格式) | - |
查询参数 (Query)
| 属性名 | 类型 | 是否必填 | 描述 | 可选值 |
|---|---|---|---|---|
page_size | integer | 是 | 分页大小(范围1-100,默认20) | - |
page_token | string | 否 | 分页token(首次请求不传) | - |
with_total | boolean | 否 | 是否返回总数 | - |
响应体(Response)
HTTP状态码: 200
响应体格式: application/json
没有可用的数据
响应体示例
json
{
"data": {
"items": [
{
"subject_id": "string",
"subject_type": "company"
}
],
"next_page_token": "string",
"total": 0
},
"code": 0,
"msg": "string"
}