Получить типы задач в организации

GET /orgs/{org}/issue-types

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

Метод GET позволяет получить типы задач в организации.

⚠️ Важное ограничение: наличие организации проверяется по названию, но набор возвращаемых данных всегда один, т.к. типы задач для всех одинаковые. При наличии организации по названию всегда возвращается одинаковый набор типов задач.

Токен

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

Заголовки запроса

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

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

Параметр	Обязательный	Тип	Описание
org	Да	string	Наименование организации

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

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

Тело запроса

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

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

curl -X GET "https://api.gitverse.ru/orgs/{org}/issue-types" \
  -H "Authorization: Bearer <YOUR-TOKEN>" \
  -H "Accept: application/vnd.gitverse.object+json;version=1"

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

В ответе приходит массив объектов типов задач:

[
  {
    "id": 3,
    "node_id": null,
    "code": "bug",
    "name": "Дефект",
    "description": null,
    "color": "#DBF0FF"
  }
]

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

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

На корневом уровне объект содержит:

Поле	Тип	Описание
id, node_id	integer / string	Идентификатор и глобальный ID узла (всегда null)
code	string	Код типа (task, bug, story, epic)
name	string	Название типа
description	string / null	Описание (всегда null)
color	string	Цвет типа

Коды ответа

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

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

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

{
  "error": {
    "code": "BAD_REQUEST",
    "documentation_url": "https://gitverse.ru/docs/developers/public-api/",
    "message": "The request format is invalid",
    "status": 400
  }
}