Интеграция внешних инструментов с Quire через Quire API — на примере n8n

Последнее обновление: 20 июля 2026 г.

Quire предоставляет открытый API, который позволяет программно читать и обновлять задачи Quire. Многие приложения в Каталоге приложений построены на прямом взаимодействии с Quire API.

Если ни одно из существующих приложений не подходит под ваши задачи, создайте собственную интеграцию. В этой статье рассматривается Quire API на примере n8n как платформы автоматизации; те же принципы применимы и к другим low-code платформам, например Zapier.

Такой путь становится всё более распространённым. По оценке Gartner, к 2025 году 70% новых приложений, разрабатываемых организациями, будут использовать low-code или no-code технологии — по сравнению с менее чем 25% в 2020 году. n8n — одна из самых популярных платформ с открытым кодом в этой категории.

Эндпоинты Quire API, используемые в этом руководстве

Какие шаги нужны для реализации?

1. Создать приложение в Quire, чтобы получить учётные данные API
2. Подготовить и запустить экземпляр n8n
3. Аутентифицироваться через OAuth2 в n8n
4. Отправить первый API-запрос (чтение задач)
5. Создать или изменить задачи через API (запись)
6. Использовать sourceRef для хранения ссылок на источник или произвольных метаданных

1. Создание приложения в Quire

Чтобы получить доступ к Quire API, нужно зарегистрировать приложение в Quire, получить client ID и client secret, а также настроить redirect URI для OAuth2.

Пошаговое руководство по созданию приложения Quire с API можно найти в нашей статье блога.

2. Подготовка n8n

Вы можете развернуть n8n самостоятельно (бесплатно) для тестирования. Подробности — в официальной документации.

После запуска создайте новый workflow, в который будете добавлять узлы для выполнения API-запросов и обработки ответов.

3. Аутентификация через OAuth2

Quire использует OAuth2 для авторизации. n8n помогает, управляя обменом токенами за вас при создании учётных данных.

• В окне workflow добавьте новые учётные данные и выберите вариант OAuth2.

• Заполните client ID, client secret, URL авторизации, URL токена и redirect URI из настроек вашего приложения Quire. Redirect URI нужно скопировать из n8n и вставить в настройки приложения Quire, чтобы обеспечить корректный процесс OAuth2. В n8n необходимо установить поле «Authentication» в значение Body, чтобы учётные данные передавались в формате, требуемом Quire.

• Нажмите Connect to my account — n8n перенаправит вас на страницу авторизации Quire. Выберите проект для авторизации и завершите процесс.

4. Отправка первого API-запроса (чтение задач)

Документация Quire API: https://quire.io/dev/api/

Используйте узел HTTP Request в n8n для вызова API. В качестве примера получим все корневые задачи проекта:

• Базовый URL: https://quire.io/api
• Эндпоинт: /task/list/id/{projectId} (замените {projectId} на ID проекта из URL вашего проекта, обычно вида https://quire.io/w/<projectId>)

В узле HTTP Request:

• Метод: GET
• URL: https://quire.io/api/task/list/id/<your_project_id>
• Authentication: Generic Credential Type
• Generic Auth Type: OAuth2 API
• OAuth2 API: <только что созданные вами учётные данные>

Выполните узел, чтобы увидеть данные ответа на правой панели; эти данные можно передать в последующие узлы для обработки.

5. Создание или изменение задач (запись)

Вы можете создавать задачи через API (см. Add a new task в документации).

• Эндпоинт: /task/id/{projectId}

В узле HTTP Request в n8n:

• Метод: POST
• URL: https://quire.io/api/task/id/<your_project_id>
• Включите Send Body и укажите обязательные поля (например, name) и необязательные, например description.

После включения Send Body обязательно установите Body Content Type в значение JSON и Specify Body в значение Using JSON. Это позволит указать тело запроса в формате JSON, как в примере ниже:

{
  "name": "Example task",
  "description": "Created via n8n"
}

Выполните узел; ответ будет содержать данные созданной задачи, и вы увидите эту задачу в вашем проекте Quire.

6. Использование sourceRef для ссылок на источник и произвольных данных

Пример тела запроса с sourceRef:

{
  "name": "Task from n8n",
  "description": "Automated task",
  "sourceRef": {
    "text": "[Open in MyApp](https://example.com/item/123)",
    "meta": { "workflowId": "n8n-abc-123" }
  }
}

sourceRef предназначен для хранения произвольных данных, связанных с задачей. Единственное предопределённое поле — text, которое поддерживает Markdown и отображается в деталях задачи Quire — идеально подходит для ссылок или коротких описаний, по которым пользователи могут кликнуть. Любые другие поля, добавленные под sourceRef, полностью зависят от вашего приложения; например, вы можете включить объект meta или другие ключи для хранения идентификаторов или флагов вашей автоматизации, но это необязательно.

Читая задачу через API, ищите объект sourceRef в возвращённом JSON. Вы можете получить доступ к полю text и любым другим сохранённым данным, что позволяет вашей автоматизации отслеживать происхождение и передавать дополнительную информацию для последующей обработки.

Ещё одно полезное поле при создании или обновлении задачи — asUser.

Если установить asUser в значение true, журнал активности будет показывать имя приложения Quire как пользователя, создавшего или обновившего задачу. Это помогает пользователям понять, какие задачи были созданы через интеграцию с API.

Как обрабатывать ошибки Quire API?

Четыре HTTP-статуса покрывают почти все проблемы, с которыми вы столкнётесь при вызове Quire API. У каждой есть конкретное решение:

• 401 Unauthorized: проверьте, действителен ли ваш токен OAuth2 и не истёк ли его срок. Убедитесь, что настройка учётных данных верна.
• 400 Bad Request: проверьте тело запроса и параметры. Убедитесь, что формат JSON верен и все обязательные поля указаны.
• 403 Forbidden: убедитесь, что у вашего приложения и пользователя есть разрешение на доступ к проекту или ресурсу.
• 404 Not Found: ещё раз проверьте эндпоинт API и используемые ID проекта/задачи.

Всегда обращайтесь к документации Quire API за подробностями о сообщениях об ошибках и обязательных параметрах. Если вы столкнулись с ошибкой, внимательно прочитайте сообщение ответа. Оно часто содержит подсказки о том, что пошло не так.

Как реализовать двустороннюю синхронизацию с Quire API?

Как описано в статье, на которую мы ссылались, вы также можете создать собственное решение для двусторонней синхронизации с помощью n8n и Quire API.

Практический пример смотрите в нашем открытом репозитории: n8n Quire API. В репозитории есть пошаговое руководство и рабочий шаблон, что упрощает реализацию двусторонней синхронизации между вашим приложением и Quire.

Пошаговое руководство по созданию двусторонней синхронизации с Quire API можно найти в нашей статье блога.

Что дальше?

Теперь у вас есть всё необходимое для чтения задач, создания задач, добавления метаданных об источнике через sourceRef и обозначения вашей интеграции в журнале активности с помощью asUser. Те же принципы применимы и к другим эндпоинтам Quire API; официальная документация API — авторитетный источник справки.

Если у вас возникнут проблемы, раздел обработки ошибок выше охватывает четыре самых распространённых HTTP-ответа. По всем остальным вопросам пишите на feedback@quire.io.

По теме: Настройка Quire MCP за 5 минут: подключение Claude, ChatGPT или любого AI-клиента — если вы хотите, чтобы AI-клиент работал с Quire напрямую вместо написания собственных вызовов API, MCP — более быстрый путь.

По теме: Пошаговое руководство по настройке вебхуков Quire — вебхуки отправляют обновления в вашу автоматизацию сразу же при изменении в Quire, вместо того чтобы ваш процесс постоянно опрашивал API.

Часто задаваемые вопросы

Что такое Quire API и что с ним можно делать?

Это открытый API для программного чтения и обновления задач Quire. Используйте его для создания собственных интеграций, когда ни одно из существующих приложений в Каталоге приложений не подходит.

Как аутентифицироваться через Quire API?

Quire использует OAuth2. Зарегистрируйте приложение Quire, получите client ID и secret, и установите поле аутентификации n8n в значение Body, чтобы учётные данные передавались в формате, ожидаемом Quire.

Можно ли использовать n8n для интеграции с Quire?

Да. Разверните n8n самостоятельно бесплатно или используйте n8n.cloud, а затем используйте узлы HTTP Request с учётными данными OAuth2 для чтения и записи задач. Те же принципы применимы к Zapier и похожим платформам.

Что такое sourceRef в Quire API?

sourceRef хранит произвольные данные для задачи. Предопределённое поле text поддерживает Markdown и отображается в деталях задачи, а вы можете добавить любые другие ключи, например meta, для отслеживания происхождения или передачи метаданных автоматизации.

Что нужно проверить, если Quire API возвращает ошибку?

401 означает проблемы с токеном, 400 — некорректное тело запроса, 403 — проблемы с разрешениями, а 404 — неверный эндпоинт или ID. Прочитайте сообщение ответа. Обычно оно указывает на решение.