Пошаговое руководство по настройке вебхуков Quire

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

Хотели бы вы, чтобы ваши приложения могли общаться друг с другом автоматически? Именно это и делают вебхуки! Думайте о них как о курьерах, которые уведомляют ваш сервер в тот момент, когда что-то происходит в ваших проектах Quire — будь то создание новой задачи, обновление назначения кем-то или отметка задачи как выполненной.

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

С чего начать работу с вебхуками Quire?

Шаг 1: Создайте свое приложение Quire

Прежде всего, вам понадобится приложение Quire. Если вы еще его не создали, загляните в наше руководство Создание приложения Quire с помощью Quire API — там всё подробно расписано.

Шаг 2: Скажите Quire, куда отправлять обновления

Теперь пора настроить эндпоинт вебхука в портале Приложения разработчиков Quire. Это просто веб-адрес, на который вы хотите, чтобы Quire отправлял уведомления, что-то вроде http://myserver/hookhandler.

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

Шаг 3: Подпишитесь на обновления

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

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app"]}' \
  https://quire.io/api/project/projectAOid

Важное примечание: убедитесь, что вы уже настроили URL вебхука до этого шага. Без этого добавление вашего приложения в качестве подписчика не сработает.

Когда обновления вам больше не нужны, просто удалите свое приложение из списка подписчиков. Вот и всё!

Подробнее см. в Update a project by OID в нашем справочнике API.

Как вебхуки работают «под капотом»?

Что вы будете получать

После завершения настройки Quire начинает отправлять вам уведомления всякий раз, когда что-то происходит в ваших отслеживаемых проектах. Они приходят в виде POST-запросов со всеми деталями в аккуратном JSON-пакете:

{
  "type": "notification",
  "secret": "your-app-secret",
  "data": {
    "type": 0, 
    "when": "2019-09-30T08:20:12.000Z",
    "what": {
      "oid": "YxjapXXRCOYxoaiCT4tT3OQm", 
      "id": 101,
      "name": "Brand new start"
    },
    "user": {
      "oid": "1AbDEFed2A5031BEDDweqmde",
      "id": "john.doer",
      "name": "John Doer"
    },
    "message": "<a href=\"https://quire.io/u/john.doer\">John Doer</a> added <a href=\"https://quire.io/w/MyProjects/101\">Brand new start</a>",
    "text": "John Doer added Brand new start",
    "url": "https://quire.io/w/MyProjects/101"
  } 
}

Безопасность прежде всего: проверка источника

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

Реагирование на разные события

В ваших проектах происходят разные вещи, и вы захотите обрабатывать их по-разному. Вот простой пример того, как реагировать в зависимости от произошедшего:

switch(json["data"]["type"]) {
  case 0:
    // new task added
    log("New task: " + json["data"]["what"]["name"]);
    break;
  case 1:
    // task removed
    log(json["data"]["user"]["name"] + " deleted " + json["data"]["what"]["name"]);
    break;
}

Какие типы событий отправляет Quire?

Quire может уведомлять вас о самых разных действиях. Вот некоторые из самых распространенных:

Нужен полный список? Загляните в нашу документацию по типам активности, чтобы увидеть всё, о чём может рассказать Quire.

Как сообщить Quire, что вы получили сообщение

Когда ваш вебхук получает уведомление, просто отправьте в ответ код успешного статуса (любой в диапазоне от 200 до 299). Это скажет Quire: «Получено, спасибо!»

Если что-то пойдет не так и вы отправите другой код статуса, не переживайте: Quire попробует отправить уведомление снова через 15 минут, затем через 1 час, и, наконец, через 1 день.

Подробнее см. в разделе «Responding and Retries» в нашей документации по API.

Как управлять вебхуками для нескольких проектов?

Работаете с несколькими проектами Quire на одном сервере? У нас есть два гибких подхода:

Вариант 1: Используйте пользовательские метки

Вы можете добавить пользовательскую метку при подписке на обновления проекта:

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app|handleProjectA"]}' \
  https://quire.io/api/project/projectAOid

Quire будет включать эту метку в каждое уведомление вебхука, что упростит определение того, из какого проекта оно пришло:

{
  "type": "notification",
  "team": "handleProjectA",
  "data": {
    // event details...
  }
}

Затем в своем коде вы можете маршрутизировать уведомления соответствующим образом:

switch(json["data"]["type"]) {
  case 0:
    // new task added
    if (json["team"] == "handleProjectA") {
      log("ProjectA has a new task: " + json["data"]["what"]["name"]);
    }
    break;
}

Вариант 2: Используйте разные пути

Предпочитаете разделять всё по отдельности? Настройте уникальные пути для каждого проекта:

curl -H 'Authorization: Bearer {access_token}' -X PUT \
  -d '{"addFollowers":["app|/projectAUpdate"]}' \
  https://quire.io/api/project/projectAOid

Таким образом Quire будет отправлять уведомления на разные подпути вашего основного эндпоинта (например, http://myserver/hookhandler/projectAUpdate), и вы сможете обрабатывать каждый проект своим собственным выделенным обработчиком.

Какой самый быстрый путь к вашему первому вебхуку?

Вот и всё! Теперь вы знаете, как настроить вебхуки и поддерживать свои приложения в идеальной синхронизации с Quire. Полную техническую документацию смотрите в разделе Webhook в нашем справочнике API.

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

Приятной разработки!

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

Что такое вебхук Quire?

Автоматическое HTTP-уведомление, которое Quire отправляет на указанный вами URL в момент, когда что-то происходит в отслеживаемом проекте, — так ваше приложение остается синхронизированным без опроса.

Как настроить вебхук в Quire?

Создайте приложение Quire, зарегистрируйте URL своего эндпоинта в портале Приложения для разработчиков, а затем добавьте свое приложение как подписчика проекта через API. Настройте URL до подписки, иначе вызов завершится ошибкой.

Как проверить, что запрос вебхука действительно пришел от Quire?

Каждая полезная нагрузка содержит поле secret вашего приложения — сравните его с вашим сохраненным секретом и отклоните любой запрос, который не совпадает.

Что произойдет, если мой сервер недоступен в момент срабатывания вебхука?

Quire повторяет попытку три раза: через 15 минут, 1 час и 1 день. Верните статус 2xx сразу после получения полезной нагрузки, чтобы остановить дальнейшие повторные попытки.

Как обрабатывать вебхуки для нескольких проектов Quire на одном сервере?

Либо прикрепите пользовательскую метку при подписке (например, app|handleProjectA) и маршрутизируйте по полю team, либо дайте каждому проекту собственный подпуть в URL вашего вебхука.