Получить метки задачи

GET /repos/{owner}/{repo}/issues/{issue_number}/labels

Описание

Метод GET возвращает список меток, назначенных указанной задаче в репозитории.

Метод применяется для отображения набора меток задачи в интерфейсе, анализа классификации задач и интеграции с внешними системами.

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

Примечание: для обычной задачи доступность данных зависит от включенного нового трекера задач; для pull request ограничение не действует.

Заголовки

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

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

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

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

Данный метод не поддерживает параметры запроса.

Тело запроса

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

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

curl -X GET "https://api.gitverse.ru/repos/user/my-repo/issues/18/labels" \
  -H "Authorization: Bearer YOUR_TOKEN" \
  -H "Accept: application/vnd.gitverse.object+json;version=1"

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

Пример ответа (`200 OK`)

При успешном выполнении сервер возвращает массив объектов меток:

[
    {
        "id": 42908,
        "name": "Priority/Blocker",
        "exclusive": true,
        "is_archived": false,
        "color": "efbee3",
        "description": "Блокирующий",
        "url": "https://api.gitverse.ru/labels/42908"
    },
    {
        "id": 126862,
        "name": "service_task",
        "exclusive": false,
        "is_archived": false,
        "color": "f29513",
        "description": "",
        "url": "https://api.gitverse.ru/labels/126862"
    },
    {
        "id": 42908,
        "name": "Priority/Blocker",
        "exclusive": true,
        "is_archived": false,
        "color": "efbee3",
        "description": "Блокирующий",
        "url": "https://api.gitverse.ru/labels/42908"
    },
    {
        "id": 126862,
        "name": "service_task",
        "exclusive": false,
        "is_archived": false,
        "color": "f29513",
        "description": "",
        "url": "https://api.gitverse.ru/labels/126862"
    }
]

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

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

На корневом уровне каждый элемент содержит:

Поле	Тип	Описание
`id`	integer	Идентификатор метки
`name`	string	Название
`description`	string	Описание
`color`	string	Цвет (hex без `#`)
`exclusive`	boolean	Признак исключительности
`is_archived`	boolean	Заархивирована ли
`url`	string	API-ссылка

Коды ответа

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

Пример тела ошибки

При ответе 401 тело ответа имеет следующий вид:

{
  "error": {
    "code": "UNAUTHORIZED",
    "documentation_url": "https://gitverse.ru/docs/developers/public-api/",
    "message": "Authorization is required",
    "status": 401
  }
}

Проводник