1. GET /repos/{owner}/{repo}/hooks — получить список вебхуков репозитория
Описание
Этот метод позволяет получить список всех вебхуков для указанного репозитория с поддержкой пагинации.
Параметры URL:
| Параметр | Обязательный | Описание |
|---|---|---|
owner | Да | Имя владельца репозитория |
repo | Да | Название репозитория |
per_page | Нет | Количество результатов на странице (максимум 30) |
page | Нет | Номер страницы результатов |
Параметры запроса:
Данный метод не требует параметров запроса.
Тело запроса:
Данный метод не требует тела запроса.
Пример запроса:
curl -X GET "https://api.gitverse.ru/repos/myuser/myrepo/hooks" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/vnd.gitverse.object+json;version=latest" \
-G \
--data-urlencode "page=1" \
--data-urlencode "per_page=30"Требования
Убедитесь, что ключ API указан корректно и обладает необходимыми правами для доступа к репозиторию:
Репозитории -> Чтение.
Ответ (200 OK):
Возвращает список вебхуков.
[
{
"id": 123,
"active": true,
"events": [
"push",
"pull_request"
],
"config": {
"url": "https://example.com/webhook",
"content_type": "json",
"secret": "secret_key"
},
"created_at": "2023-01-01T00:00:00Z",
"updated_at": "2023-01-01T00:00:00Z",
"last_response_status": "200"
}
]Поля ответа:
| Поле | Тип | Описание |
|---|---|---|
id | integer | Уникальный идентификатор вебхука |
active | boolean | Активен ли вебхук |
events | array of strings | События, на которые реагирует вебхук |
config | object | Конфигурация вебхука |
created_at | string | Дата создания вебхука |
updated_at | string | Дата последнего обновления вебхука |
last_response_status | string | Статус последнего ответа от вебхука |
Поля конфигурации config:
| Поле | Тип | Описание |
|---|---|---|
url | string | URL, на который будут отправляться вебхуки |
content_type | string | Тип контента |
secret | string | Секретный ключ для подписи запросов |
Формат ответа: application/vnd.gitverse.object+json;version=latest
Коды ответов
| Код | Статус | Описание |
|---|---|---|
200 | Ok | Запрос выполнен успешно, вебхуки получены |
400 | Bad Request | Некорректные параметры запроса |
401 | Unauthorized | Необходима авторизация |
403 | Forbidden | Доступ запрещен |
404 | Not Found | Репозиторий не найден |
500 | Internal Server Error | Внутренняя ошибка сервера |
Примечания:
- возвращаемый список вебхуков может быть ограничен параметрами
per_pageиpage.