17. GET /repos/{owner}/{repo}/issues/{index}/labels — получить метки задачи или запроса на слияние
Описание
Возвращает список меток (labels), назначенных на задачу (issue) или на запрос на слияние (pr) с указанным индексом.
Метод полезен для фильтрации, анализа приоритетов, категорий и других атрибутов задач.
Сейчас метод может возвращать метки только для запросов на слияние (pr). Возможность получения меток задач (issues) будет реализована позже.
Параметры URL
| Параметр | Обязательный | Описание |
|---|---|---|
owner | Да | Владелец репозитория (пользователь или организация) |
repo | Да | Название репозитория (без расширения .git) |
index | Да | Индекс задачи или пул-реквеста в репозитории (целое число) |
Параметры запроса
Данный метод не принимает параметров в строке запроса.
Тело запроса
Данный метод не требует тела запроса.
Пример запроса
curl -X GET "https://api.gitverse.ru/public/api/repos/gitverse-team/core-api/issues/42/labels" \
-H "Authorization: Bearer YOUR_TOKEN" \
-H "Accept: application/vnd.gitverse.object+json;version=1"Ответ (200 OK)
Пример JSON-ответа:
[
{
"id": 101,
"name": "bug",
"color": "d73a4a",
"description": "Something isn't working",
"exclusive": false,
"is_archived": false,
"url": "https://gitverse.ru/api/public/api/repos/gitverse-team/core-api/labels/bug"
},
{
"id": 102,
"name": "priority:high",
"color": "b60205",
"description": "High priority issue",
"exclusive": false,
"is_archived": false,
"url": "https://gitverse.ru/api/public/api/repos/gitverse-team/core-api/labels/priority:high"
}
]Формат ответа
application/vnd.gitverse.object+json;version=1
Поля каждой метки
| Поле | Тип | Описание |
|---|---|---|
id | integer | Уникальный идентификатор метки |
name | string | Название метки |
color | string | Цвет метки в формате HEX (без #) |
description | string | Описание метки |
exclusive | boolean | Является ли метка исключающей (только одна из группы) |
is_archived | boolean | Архивирована ли метка |
url | string | Ссылка на метку в API |
Коды ответа
| Код | Статус | Описание |
|---|---|---|
| 200 | OK | Список меток успешно получен |
| 401 | Unauthorized | Не передан или недействителен токен авторизации |
| 403 | Forbidden | Нет прав на чтение репозитория |
| 404 | Not Found | Репозиторий или задача с указанным индексом не найдены |
| 500 | Internal Server Error | Внутренняя ошибка сервера |