Получить элемент проекта репозитория

GET /repos/{owner}/{repo}/projects/{project_number}/items/{item_id}

Описание

Метод GET возвращает указанный элемент проекта репозитория по его идентификатору. В GitVerse элемент проекта — всегда задача, поэтому в поле content возвращается полная структура задачи. Метод применяется для получения актуального положения задачи на Kanban-доске проекта (колонка указана в поле fields) при интеграции с внешними системами.

⚠️ Важно: учитывается приватность репозитория и проекта. Если репозиторий или проект приватный, а запрос выполняется не владельцем, соавтором или участником команды с доступом к репозиторию, возвращается ошибка 404.

Токен

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

Заголовки

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

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

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

ПараметрТипОбязательныйОписание
ownerstringДаВладелец репозитория (логин пользователя или имя организации)
repostringДаНазвание репозитория (без расширения .git)
project_numberintegerДаНомер проекта
item_idintegerДаИдентификатор элемента проекта

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

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

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

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

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

Замените <YOUR-TOKEN> на ваш личный токен доступа.

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

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

{
  "id": 3,
  "node_id": null,
  "project_url": "/repos/myorg/backend-api/projects/1",
  "content": {
    "id": 163200,
    "number": 156,
    "title": "Добавить пагинацию в список проектов",
    "state": "open",
    "user": {
      "id": 516,
      "login": "user123"
    },
    "assignee": null,
    "labels": [],
    "created_at": "2026-09-14T10:00:00Z",
    "updated_at": "2026-09-17T11:05:00Z",
    "html_url": "https://gitverse.ru/myorg/backend-api/issues/156"
  },
  "content_type": "Issue",
  "created_at": null,
  "updated_at": null,
  "archived_at": null,
  "item_url": "/repos/myorg/backend-api/projects/1/items/3",
  "fields": [
    {
      "name": "Status",
      "value": {
        "id": "8",
        "name": {
          "raw": "In progress"
        },
        "color": "YELLOW"
      }
    }
  ]
}

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

Ответ — объект ProjectItem (элемент проекта). Он содержит:

ПолеТипОписание
idintegerУникальный идентификатор элемента проекта
node_idstringГлобальный ID узла (GraphQL). В ответах GitVerse всегда null
project_urlstringAPI URL для доступа к проекту
contentobjectОбъект, которым является элемент проекта. В GitVerse всегда задача — см. граф объектов, раздел «Объект Issue»
content_typestringТип контента элемента. В GitVerse всегда Issue
created_atstring / nullВремя создания элемента. В ответах GitVerse всегда null
updated_atstring / nullВремя обновления элемента. В ответах GitVerse всегда null
archived_atstring / nullВремя архивирования элемента. В ответах GitVerse всегда null
item_urlstringAPI URL для доступа к элементу проекта
fieldsarrayПоля элемента проекта. Сейчас содержит только одно поле — статус (колонку, в которой находится задача)

Структура объекта fields (поле Status):

ПолеТипОписание
namestringНазвание поля. Сейчас всегда Status
value.idstringИдентификатор колонки (строкой)
value.name.rawstringНазвание колонки (например, In progress)
value.colorstringЦвет колонки (например, YELLOW)

Примечание: поле creator (пользователь, добавивший элемент в проект) в ответах GitVerse не возвращается.

Коды ответа

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

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

Пример ответа с ошибкой

Пример: элемент с идентификатором 999 в проекте не существует. Сервер вернет ответ 404 Not Found:

{
  "message": "Not Found",
  "documentation_url": "https://gitverse.ru/docs/developers/public-api/errors"
}

Прочие коды ошибки возвращают ответ той же структуры, например 401 Unauthorized:

{
  "message": "Unauthorized",
  "documentation_url": "https://gitverse.ru/docs/developers/public-api/errors"
}

Особенности метода

  • в GitVerse элементами проекта могут быть только задачи;
  • item_id — это идентификатор элемента проекта, а не номер задачи. Номер задачи находится в поле content.number.

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

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