企业公告横幅
使用企业公告横幅 API，可以获取、设置和删除企业的公告横幅。
Get announcement banner for enterprise
Gets the announcement banner currently set for the enterprise.
“Get announcement banner for enterprise”的参数
| 标头 |
|---|
| 名称, 类型, 说明 |
accept string Setting to |
| 路径参数 |
| 名称, 类型, 说明 |
enterprise string 必须The slug version of the enterprise name. You can also substitute this value with the enterprise id. |
“Get announcement banner for enterprise”的 HTTP 响应状态代码
| 状态代码 | 说明 |
|---|---|
200 | OK |
“Get announcement banner for enterprise”的示例代码
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>"\
-H "X-GitHub-Api-Version: 2022-11-28" \
https://api.github.com/enterprises/ENTERPRISE/announcementAnnouncement banner
Status: 200{
"announcement": "Very **important** announcement about _something_.",
"expires_at": "2021-01-01T00:00:00.000+00:00",
"user_dismissible": false
}Set announcement banner for enterprise
Sets the announcement banner to display for the enterprise.
“Set announcement banner for enterprise”的参数
| 标头 |
|---|
| 名称, 类型, 说明 |
accept string Setting to |
| 路径参数 |
| 名称, 类型, 说明 |
enterprise string 必须The slug version of the enterprise name. You can also substitute this value with the enterprise id. |
| 正文参数 |
| 名称, 类型, 说明 |
announcement string or null 必须The announcement text in GitHub Flavored Markdown. For more information about GitHub Flavored Markdown, see "Basic writing and formatting syntax." |
expires_at string or null The time at which the announcement expires. This is a timestamp in ISO 8601 format: |
“Set announcement banner for enterprise”的 HTTP 响应状态代码
| 状态代码 | 说明 |
|---|---|
200 | OK |
“Set announcement banner for enterprise”的示例代码
curl -L \
-X PATCH \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>"\
-H "X-GitHub-Api-Version: 2022-11-28" \
https://api.github.com/enterprises/ENTERPRISE/announcement \
-d '{"announcement":"Very **important** announcement about _something_.","expires_at":"2021-01-01T00:00:00.000+00:00","user_dismissible":false}'Announcement banner
Status: 200{
"announcement": "Very **important** announcement about _something_.",
"expires_at": "2021-01-01T00:00:00.000+00:00",
"user_dismissible": false
}Remove announcement banner from enterprise
Removes the announcement banner currently set for the enterprise.
“Remove announcement banner from enterprise”的参数
| 标头 |
|---|
| 名称, 类型, 说明 |
accept string Setting to |
| 路径参数 |
| 名称, 类型, 说明 |
enterprise string 必须The slug version of the enterprise name. You can also substitute this value with the enterprise id. |
“Remove announcement banner from enterprise”的 HTTP 响应状态代码
| 状态代码 | 说明 |
|---|---|
204 | No Content |
“Remove announcement banner from enterprise”的示例代码
curl -L \
-X DELETE \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>"\
-H "X-GitHub-Api-Version: 2022-11-28" \
https://api.github.com/enterprises/ENTERPRISE/announcementResponse
Status: 204