ClickUp

ClickUp API integration with managed OAuth. Получайте доступ к задачам, спискам, папкам, пространствам, рабочим областям и пользователям, а также управляйте вебхуками для эффективной организации рабочих процессов.

Используйте этот инструмент, когда необходимо управлять задачами, отслеживать проекты или интегрировать рабочие процессы ClickUp. Для работы с другими сторонними сервисами рекомендуется использовать универсальный API-шлюз.

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

Пример запроса для получения списка рабочих пространств (команд):

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://gateway.maton.ai/clickup/api/v2/team')
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/clickup/{native-api-path}

Замените {native-api-path} на конкретный путь API ClickUp. Шлюз автоматически проксирует запросы к api.clickup.com и добавляет OAuth-токен.

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

Каждый запрос должен содержать API-ключ Maton в заголовке:

Authorization: Bearer $MATON_API_KEY

Установите переменную окружения:

export MATON_API_KEY="YOUR_API_KEY"

Получение API-ключа

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

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

Вы можете управлять OAuth-подключениями ClickUp через специальный интерфейс.

Список подключений

python <<'EOF'
import urllib.request, os, json
req = urllib.request.Request('https://ctrl.maton.ai/connections?app=clickup&status=ACTIVE')
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
data = json.dumps({'app': 'clickup'}).encode()
req = urllib.request.Request('https://ctrl.maton.ai/connections', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Работа с ресурсами

ClickUp использует иерархию:

• Workspace (команда)
• Space (пространство)
• Folder (папка)
• List (список)
• Task (задача)

Получение списков

GET /clickup/api/v2/folder/{folder_id}/list

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

• archived — включать архивные списки (true/false)

Создание списка

python <<'EOF'
import urllib.request, os, json
data = json.dumps({'name': 'New List'}).encode()
req = urllib.request.Request('https://gateway.maton.ai/clickup/api/v2/folder/456789/list', data=data, method='POST')
req.add_header('Authorization', f'Bearer {os.environ["MATON_API_KEY"]}')
req.add_header('Content-Type', 'application/json')
print(json.dumps(json.load(urllib.request.urlopen(req)), indent=2))
EOF

Примечания

• ID задач представлены строками
• Временные метки — в миллисекундах Unix
• Приоритеты: 1 — срочно, 2 — высокий, 3 — обычный, 4 — низкий
• Рабочие пространства в API называются «teams»
• Статусы должны точно совпадать с настройками списка
• Пагинация постраничная, начиная с 0