Jira

Jira — это интеграция с Jira Cloud API через управляемую OAuth-аутентификацию. Она позволяет выполнять поиск задач с помощью JQL, создавать и обновлять тикеты, управлять проектами и переходами, а также автоматизировать рабочие процессы.

Используйте этот инструмент, когда необходимо взаимодействовать с задачами Jira, проектами или workflow. Для работы с другими сторонними сервисами рекомендуется использовать API Gateway.

Быстрый старт

Сначала получите Cloud ID вашего Jira-инстанса:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/jira/oauth/token/accessible-resources')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Затем выполните поиск задач:

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/jira/ex/jira/{cloudId}/rest/api/3/search/jql?jql=project%3DKEY&maxResults=10')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Базовый URL

https://gateway.maton.ai/jira/{native-api-path}

Замените {native-api-path} на фактический путь к endpoint Jira API. Gateway проксирует запросы к api.atlassian.com и автоматически подставляет OAuth-токен.

Получение Cloud ID

Jira Cloud требует Cloud ID для выполнения запросов. Получить его можно следующим образом:

GET /jira/oauth/token/accessible-resources

Пример ответа:

[
 {
 "id": "62909843-b784-4c35-b770-e4e2a26f024b",
 "url": "https://yoursite.atlassian.net",
 "name": "yoursite"
 }
]

Аутентификация

Все запросы требуют API-ключ Maton в заголовке:

Authorization: Bearer $MATON_API_KEY

Задайте переменную окружения:

export MATON_API_KEY="YOUR_API_KEY"

Как получить API-ключ

• Войдите или зарегистрируйтесь на maton.ai
• Перейдите в настройки: maton.ai/settings
• Скопируйте ваш API-ключ

Управление подключениями

Управление OAuth-подключениями Jira осуществляется через панель:

https://ctrl.maton.ai

Здесь можно создавать, просматривать и контролировать подключения к Jira и другим сервисам.