Что это
Jira Service Management API нужен для работы с сервисными обращениями: запросами клиентов, типами обращений, комментариями и доступными данными SLA. Он помогает подключить внутренний отчет или подготовить данные для сотрудника поддержки.
Карточка относится к облачной версии. Ее маршруты начинаются с /rest/servicedeskapi и не совпадают с Jira Platform API. Обычная задача Jira и обращение, созданное через сервисный портал, также не во всем взаимозаменяемы.
API сам не классифицирует проблему и не отвечает за правильность текста модели. Если поверх него работает ИИ, он должен видеть только разрешенные обращения, а отправка ответа клиенту должна проходить отдельную проверку.
Ключевые параметры
- Категория: Инструменты разработчика
- Сложность: Для разработчика
- Запуск: Около 30 минут
- Open-source: Нет
- Данные: Не известно
- Чувствительные данные: Только с настройками
Сильные стороны
- Предоставляет данные обращений в терминах сервисного портала.
- Позволяет получать отдельное обращение без выгрузки всей очереди.
- Учитывает права и роль пользователя при доступе к запросу.
- Дополняет Jira Platform API специальными сервисными операциями.
Ограничения
- Клиенты и сотрудники имеют разный доступ; клиент не получает всю очередь.
- Для обращения важны service desk, request type и соответствующие поля.
- Не все операции платформы доступны через /rest/servicedeskapi.
- Комментарии и вложения могут содержать данные, которые нельзя передавать внешней модели.
Как использовать
1. Подготовка. Создайте учебное обращение через тестовый сервисный портал и запишите его ключ. Выберите роль, от имени которой интеграция должна читать запрос.
2. Настройка. Подключите OAuth 2.0 с минимальными правами на нужный ресурс и сохраните токен вне кода. Для OAuth базовый URL включает https://api.atlassian.com/ex/jira/<cloudId>; дальше используется /rest/servicedeskapi.
3. Первый результат. Выполните GET /rest/servicedeskapi/request/{issueIdOrKey} для учебного обращения. Сохраните ключ, тип обращения и доступные сведения о его состоянии для внутренней сводки.
4. Проверка. Сверьте ответ с порталом под той же ролью. Отдельно проверьте отказ на чужое недоступное обращение. При дальнейшем добавлении комментариев проверяйте публичность до отправки; операции записи пока не подключайте.
Доступ и оплата
- Модель оплаты: Не уточнено
- Работа в РФ: Нужно проверять
- VPN: Не известно
- Русский интерфейс: Не известно
- Русский язык: Не известно
Доступ зависит от облачного аккаунта, роли и разрешений приложения. API не включает отдельного бесплатного ИИ-оператора. В корпоративной интеграции согласуйте хранение клиентских данных и условия Atlassian.
Когда не подходит
- Выдать клиентскому аккаунту права сотрудника по умолчанию
- Считать любой issue полноценным запросом сервисного портала
- Отправить внутренние сведения клиенту без проверки видимости
Альтернативы
Freshservice API и Zendesk API работают с обращениями соответствующих helpdesk. Jira REST API нужен для общих операций с задачами Jira, которые не представлены в сервисном API.
