Удалить вебхук
DELETE /repos/{owner}/{repo}/hooks/{hook_id}
Описание
Этот метод позволяет удалить вебхук из репозитория.
Токен
Требуется токен с правами на Запись для Репозитория.
Заголовки
| Параметр | Обязательный | Описание |
|---|---|---|
Authorization | Да | Заголовок авторизации. Формат: Bearer <token> |
Accept | Нет | Тип содержимого ответа. Рекомендуется установить значение application/vnd.gitverse.object+json;version=latest |
Параметры пути
| Параметр | Обязательный | Описание |
|---|---|---|
owner | Да | Имя владельца репозитория |
repo | Да | Название репозитория |
hook_id | Да | Идентификатор вебхука |
Параметры запроса
Данный метод не требует параметров запроса.
Тело запроса
Данный метод не требует тела запроса.
Пример запроса
curl -X DELETE "https://api.gitverse.ru/repos/myuser/myrepo/hooks/123" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/vnd.gitverse.object+json;version=latest"Ответ (204 No Content)
Успешное удаление вебхука. Нет содержимого ответа.
Формат ответа: application/vnd.gitverse.object+json;version=latest
Коды ответов
| Код | Статус | Описание |
|---|---|---|
204 | No Content | Вебхук успешно удален |
400 | Bad Request | Некорректные параметры запроса |
401 | Unauthorized | Необходима авторизация |
403 | Forbidden | Доступ запрещен |
404 | Not Found | Вебхук или репозиторий не найдены |
429 | Too Many Requests | Превышен лимит запросов |
500 | Internal Server Error | Внутренняя ошибка сервера |
Пример тела ошибки
При ответе 400 тело ответа имеет следующий вид:
{
"error": {
"code": "BAD_REQUEST",
"documentation_url": "https://gitverse.ru/docs/developers/public-api/",
"message": "The request format is invalid",
"status": 400
}
}Примечания
- после удаления вебхук больше не будет отправлять уведомления;
- операция необратима.