Получить список элементов проекта репозитория
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 запроса необходимо передать следующие идентификаторы ресурса:
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| owner | string | Да | Владелец репозитория (логин пользователя или имя организации) |
| repo | string | Да | Название репозитория (без расширения .git) |
| project_number | integer | Да | Номер проекта |
Параметры запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| q | string | Нет | Фильтр по названию задачи |
| milestone | integer | Нет | ID вехи |
| state | string | Нет | Состояние задачи: open — задачи со статусом, не равным Done, closed — задачи со статусом Done |
| assignee | string | Нет | Логин пользователя для фильтрации по исполнителю задачи |
| type | string | Нет | Код типа задачи: task, bug, story, epic |
| creator | string | Нет | Логин пользователя для фильтрации по автору задачи |
| labels | string | Нет | Названия меток через запятую (например, bug,ui,high). Возвращаются задачи, содержащие одновременно все указанные метки |
| sort | string | Нет | Тип сортировки: created (по дате создания, по умолчанию), updated (по дате обновления), comments (по количеству комментариев), due_date (по контрольному сроку) |
| direction | string | Нет | Направление сортировки: desc (от больших к меньшим, по умолчанию), asc (от меньших к большим) |
| since | string | Нет | Дата последнего обновления. Оставляются только задачи, обновленные после заданного значения |
| per_page | integer | Нет | Количество задач в срезе (максимум 100). По умолчанию: 30 |
| page | integer | Нет | Номер страницы результатов. По умолчанию: 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 (элемент проекта). Каждый объект содержит:
| Поле | Тип | Описание |
|---|---|---|
id | integer | Уникальный идентификатор элемента проекта |
node_id | string | Глобальный ID узла (GraphQL). В ответах GitVerse всегда null |
project_url | string | API URL для доступа к проекту |
content | object | Объект, которым является элемент проекта. В GitVerse всегда задача — см. граф объектов, раздел «Объект Issue» |
content_type | string | Тип контента элемента. В GitVerse всегда Issue |
created_at | string / null | Время создания элемента. В ответах GitVerse всегда null |
updated_at | string / null | Время обновления элемента. В ответах GitVerse всегда null |
archived_at | string / null | Время архивирования элемента. В ответах GitVerse всегда null |
item_url | string | API URL для доступа к элементу проекта |
fields | array | Поля элемента проекта. Сейчас содержит только одно поле — статус (колонку, в которой находится задача) |
Структура объекта fields (поле Status):
| Поле | Тип | Описание |
|---|---|---|
name | string | Название поля. Сейчас всегда Status |
value.id | string | Идентификатор колонки (строкой) |
value.name.raw | string | Название колонки (например, Done) |
value.color | string | Цвет колонки (например, PURPLE) |
Примечание: поле
creator(пользователь, добавивший элемент в проект) в ответах GitVerse не возвращается.
Коды ответа
Результат выполнения запроса определяется по HTTP-статусу:
| Код | Статус | Описание |
|---|---|---|
| 200 | OK | Список элементов успешно получен |
| 400 | Bad Request | Некорректные параметры запроса |
| 401 | Unauthorized | Не передан или невалиден токен авторизации |
| 403 | Forbidden | Недостаточно прав на чтение репозитория |
| 404 | Not Found | Ресурс не найден либо нет доступа к нему |
| 422 | Unprocessable Entity | Ошибка валидации |
| 500 | Internal 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.