Получить веху репозитория

GET /repos/{owner}/{repo}/milestones/{id}

Описание

Метод GET возвращает информацию о вехе указанного репозитория по ее идентификатору. Метод применяется для получения актуального состояния вехи, проверки срока выполнения и количества задач, а также для интеграции с внешними системами управления задачами.

Токен

Требуется токен с правами на Чтение для Репозитория.

Заголовки

Параметр	Обязательный	Описание
Accept	Нет	Тип содержимого ответа. Рекомендуется установить значение `application/vnd.gitverse.object+json;version=latest`
Authorization	Да	Токен доступа. Формат: `Bearer <YOUR-TOKEN>` или `token <YOUR-TOKEN>`

Параметры пути

В URL запроса необходимо передать следующие идентификаторы ресурса:

Параметр	Тип	Обязательный	Описание
owner	string	Да	Владелец репозитория (логин пользователя или имя организации)
repo	string	Да	Название репозитория (без расширения `.git`)
id	integer	Да	Уникальный идентификатор вехи

Параметры и тело запроса

Данный метод не принимает параметров строки запроса и не требует тела запроса.

Пример запроса

Ниже приведен пример использования curl для получения информации о вехе с идентификатором 1.

curl -X GET "https://api.gitverse.ru/repos/myorg/backend-api/milestones/1" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Accept: application/vnd.gitverse.object+json;version=latest"

Замените YOUR_TOKEN на ваш личный токен доступа.

Ответ при успешном выполнении (200 OK)

При успешном выполнении запроса сервер вернет ответ с кодом 200 OK и телом в формате JSON, содержащим объект вехи:

{
  "id": 1,
  "title": "Версия 1.0",
  "description": "Выпуск первой стабильной версии",
  "state": "open",
  "open_issues": 5,
  "closed_issues": 3,
  "due_on": "2026-12-01T00:00:00Z",
  "created_at": "2026-10-01T09:00:00Z",
  "updated_at": "2026-10-20T14:30:00Z",
  "closed_at": null
}

Структура ответа

Ответ — объект Milestone (веха). Полная структура описана в графе объектов, раздел «Объект Milestone».

На корневом уровне объект содержит:

Поле	Тип	Описание
`id`	integer	Уникальный идентификатор вехи
`title`, `description`	string / null	Название и описание вехи
`state`	string	Состояние вехи (`open`, `closed`)
`open_issues`, `closed_issues`	integer	Количество открытых и закрытых задач в вехе
`due_on`	string (date-time) / null	Срок выполнения
`created_at`, `updated_at`	string (date-time)	Даты создания и последнего обновления
`closed_at`	string (date-time) / null	Дата закрытия вехи (если открыта — `null`)

Коды ответа

Результат выполнения запроса определяется по HTTP-статусу:

Код	Статус	Описание
200	OK	Информация о вехе успешно получена
401	Unauthorized	Не передан или невалиден токен авторизации
403	Forbidden	Нет прав на чтение репозитория
404	Not Found	Репозиторий или веха не найдены
500	Internal Server Error	Внутренняя ошибка сервера GitVerse

Формат ответа и заголовки

Метод возвращает ответ в формате JSON. Заголовок Content-Type в ответе устанавливается в application/vnd.gitverse.object+json;version=latest.

Проводник