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

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

Описание

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

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

Токен

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

Заголовки

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

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

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

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

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

ПараметрТипОбязательныйОписание
qstringНетФильтр по названию задачи
milestoneintegerНетID вехи
statestringНетСостояние задачи: open — задачи со статусом, не равным Done, closed — задачи со статусом Done
assigneestringНетЛогин пользователя для фильтрации по исполнителю задачи
typestringНетКод типа задачи: task, bug, story, epic
creatorstringНетЛогин пользователя для фильтрации по автору задачи
labelsstringНетНазвания меток через запятую (например, bug,ui,high). Возвращаются задачи, содержащие одновременно все указанные метки
sortstringНетТип сортировки: created (по дате создания, по умолчанию), updated (по дате обновления), comments (по количеству комментариев), due_date (по контрольному сроку)
directionstringНетНаправление сортировки: desc (от больших к меньшим, по умолчанию), asc (от меньших к большим)
sincestringНетДата последнего обновления. Оставляются только задачи, обновленные после заданного значения
per_pageintegerНетКоличество задач в срезе (максимум 100). По умолчанию: 30
pageintegerНетНомер страницы результатов. По умолчанию: 1

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

Ниже приведен пример использования curl для получения элементов проекта с номером 1: открытых задач, отсортированных по дате обновления.

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

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

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

В ответ возвращается массив элементов проекта (задач):

[
  {
    "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"
        }
      }
    ]
  },
  {
    "id": 4,
    "node_id": null,
    "project_url": "/repos/myorg/backend-api/projects/1",
    "content": {
      "id": 163198,
      "number": 154,
      "title": "Исправить аватар пользователя в профиле",
      "state": "closed",
      "user": {
        "id": 516,
        "login": "user123"
      },
      "assignee": null,
      "labels": [],
      "created_at": "2026-09-12T09:00:00Z",
      "updated_at": "2026-09-16T14:20:00Z",
      "html_url": "https://gitverse.ru/myorg/backend-api/issues/154"
    },
    "content_type": "Issue",
    "created_at": null,
    "updated_at": null,
    "archived_at": null,
    "item_url": "/repos/myorg/backend-api/projects/1/items/4",
    "fields": [
      {
        "name": "Status",
        "value": {
          "id": "9",
          "name": {
            "raw": "Done"
          },
          "color": "PURPLE"
        }
      }
    ]
  }
]

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

Ответ — массив объектов 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Название колонки (например, Done)
value.colorstringЦвет колонки (например, PURPLE)

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

Коды ответа

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

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

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

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

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

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

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

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

  • в ответе могут быть только задачи: проект в GitVerse содержит только задачи как элементы;
  • параметр state использует статус задачи на доске: open — задачи со статусом, не равным Done, closed — задачи со статусом Done;
  • фильтр labels принимает несколько названий меток через запятую — возвращаются задачи, содержащие одновременно все указанные метки;
  • по умолчанию результаты сортируются по дате создания в порядке убывания (sort=created, direction=desc);
  • пагинация: per_page (по умолчанию 30, максимум 100) и page (по умолчанию 1).

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

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