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

GET /repos/{owner}/{repo}/projects/{project_id}

Описание

Метод GET возвращает детальную информацию о конкретном проекте в указанном репозитории по его идентификатору. В ответ включается список колонок проекта (Kanban-доски), что позволяет получить полное представление о структуре рабочих процессов. Метод применяется для отображения детальной информации о проекте в интерфейсе, интеграции с внешними системами управления задачами и автоматизации рабочих процессов.

Токен

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

Заголовки

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

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

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

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

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

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

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

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

curl -X GET "https://api.gitverse.ru/repos/myorg/backend-api/projects/42" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=latest"

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

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

Если проект найден, сервер вернет ответ с кодом 200 OK и телом в формате JSON, содержащим объект проекта:

{
  "id": 42,
  "title": "Release planning",
  "description": "Tasks for the next release",
  "private": true,
  "state": "open",
  "created_at": "2026-09-14T10:00:00Z",
  "updated_at": "2026-09-14T12:30:00Z",
  "closed_at": null,
  "columns": [
    {
      "id": 7,
      "title": "To Do",
      "color": "#0969DA",
      "default": true,
      "sorting": 1,
      "created_at": "2026-09-14T10:00:00Z",
      "updated_at": "2026-09-14T10:00:00Z"
    },
    {
      "id": 8,
      "title": "In progress",
      "color": "#E3B341",
      "default": false,
      "sorting": 2,
      "created_at": "2026-09-14T10:00:00Z",
      "updated_at": "2026-09-14T12:30:00Z"
    },
    {
      "id": 9,
      "title": "Done",
      "color": "#1A7F37",
      "default": false,
      "sorting": 3,
      "created_at": "2026-09-14T10:00:00Z",
      "updated_at": "2026-09-14T10:00:00Z"
    }
  ]
}

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

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

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

Поле	Тип	Описание
`id`	integer	Уникальный идентификатор проекта
`title`, `description`	string	Название и описание проекта
`private`	boolean	Флаг приватности проекта (`true` — приватный, `false` — публичный)
`state`	string	Состояние проекта (`open`, `closed`)
`created_at`, `updated_at`	string (date-time)	Даты создания и последнего обновления
`closed_at`	string (date-time) / null	Дата закрытия проекта (если открыт — `null`)
`columns`	array	Список колонок проекта (см. `ProjectColumn`)

Вложенные объекты описаны в графе объектов.

Коды ответа

Результат выполнения запроса определяется по 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.

Проводник