Недавно мы перенесли некоторые из документации по REST API. Если вы не можете найти то, что ищете, попробуйте страницу REST API Действия.
Объявление
Используйте REST API для управления глобальным баннером объявлений на предприятии.
About announcements
You can use the REST API to manage the global announcement banner in your enterprise. For more information, see "Customizing user messages for your enterprise."
Get the global announcement banner
Gets the current message and expiration date of the global announcement banner in your enterprise.
Коды состояния HTTP-ответа для "Get the global announcement banner"
Код состояния | Описание |
---|---|
200 | OK |
Примеры кода для "Get the global announcement banner"
curl -L \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/enterprise/announcement
Announcement banner
Status: 200
{
"announcement": "Very **important** announcement about _something_.",
"expires_at": "2021-01-01T00:00:00.000+00:00",
"user_dismissible": false
}
Set the global announcement banner
Sets the message and expiration time for the global announcement banner in your enterprise.
Параметры для "Set the global announcement banner"
Заголовки |
---|
Имя, Тип, Описание |
accept string Setting to |
Параметры запроса |
Имя, Тип, Описание |
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: |
Коды состояния HTTP-ответа для "Set the global announcement banner"
Код состояния | Описание |
---|---|
200 | OK |
Примеры кода для "Set the global announcement banner"
curl -L \
-X PATCH \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/enterprise/announcement \
-d '{"announcement":"Very **important** announcement about _something_.","expires_at":"2021-01-01T00:00:00.000+00:00"}'
Announcement banner
Status: 200
{
"announcement": "Very **important** announcement about _something_.",
"expires_at": "2021-01-01T00:00:00.000+00:00",
"user_dismissible": false
}
Remove the global announcement banner
Removes the global announcement banner in your enterprise.
Коды состояния HTTP-ответа для "Remove the global announcement banner"
Код состояния | Описание |
---|---|
204 | No Content |
Примеры кода для "Remove the global announcement banner"
curl -L \
-X DELETE \
-H "Accept: application/vnd.github+json" \
-H "Authorization: Bearer <YOUR-TOKEN>" \
http(s)://HOSTNAME/api/v3/enterprise/announcement
Response
Status: 204