Запрашивайте, когда хотите. Получайте автоматически, когда это важно.
SimplyPrint API отлично подходит, когда вопросы задаёт ваша система. Webhooks позволяют SimplyPrint сообщать вам о любом изменении сразу, без опроса, запланированных задач и пропущенных событий.
Отправка событий вместо опроса
Webhook представляет собой URL-адрес, который вы передаёте SimplyPrint. Каждый раз, когда в аккаунте происходит событие, на которое вы подписаны, например запускается печать, задание завершается ошибкой, элемент очереди одобряется или запас детали опускается ниже заданного уровня, SimplyPrint отправляет на этот URL HTTP POST с данными события. Не нужны циклы опроса, управление лимитами запросов и сомнения, не пропущено ли событие. Вы получаете поток событий, который можно подключить к любой системе с поддержкой HTTP.
Создавайте столько Webhooks, сколько нужно. Точно выбирайте события для каждого из них. Отключайте любой из них без удаления. Проверяйте каждую доставку в истории. Это тот же базовый механизм, на котором работает остальной веб, теперь подключённый к вашему парку 3D-принтеров.
Четыре формата доставки: одна система вебхуков
SimplyPrint автоматически определяет назначение по URL и форматирует полезную нагрузку нужным образом. Настройте вебхук для Discord, и получите корректный embed с цветом, полями и временной меткой. Настройте его для Slack, и получите сообщение Slack Block Kit. Для Microsoft Teams будет адаптивная карточка. Для других сервисов будет чистый JSON, с которым можно делать что угодно.
Чистое тело POST-запроса для Zapier, n8n, Make или собственного бэкенда.
Вставьте URL вебхука канала и получите расширенные карточки без бота.
Нативные сообщения Block Kit из любого входящего вебхука Slack.
Адаптивные карточки, отправляемые в рабочий процесс Teams или на URL коннектора.
Все события, создаваемые вашим парком, сгруппированы по понятным категориям
Подпишите каждый вебхук только на нужные ему события. Каналу Discord для всей команды могут быть нужны лишь печать завершена и печать не удалась. Автоматизацию Zapier можно подписать на элемент очереди одобрен. Дашборду техобслуживания могут понадобиться все события maintenance.*. Настройку для каждого вебхука определяете вы.
- События заданий печати: запуск, пауза, возобновление, отмена, завершение, сбой, очистка стола, пропуск объектов
- События принтера: состояние AutoPrint, размер сопла, материал, добавление / удаление пользовательского тега, состояние неисправности, состояние ИИ, обнаружение сбоя ИИ, ложное срабатывание ИИ, максимальное число циклов AutoPrint
- События организации: состояние AutoPrint аккаунта, регистрация нового пользователя, ожидание одобрения пользователя
- Очередь печати: элемент добавлен, удалён, перемещён, восстановлен, ожидает утверждения, утверждён, отклонён, очередь очищена
- Филамент: создан, обновлён, удалён, назначен принтеру, снят с принтера
- Техобслуживание - задание создано / запущено / завершено / отменено / просрочено / открыто повторно / обновлено / удалено, сообщено о проблеме / проблема устранена, запчасть создана / обновлена / удалена, запас скорректирован, низкий запас, задача выполнена / пропущена, расписание создано / обновлено / удалено
- Баланс: списание, возврат, пополнение, корректировка
- Квота: новый запрос, запрос обработан, скорректирована, сброшена
Формат полезной нагрузки Webhook, с которым легко работать в коде
Каждая доставка вебхука в обычном формате имеет одинаковую внешнюю структуру: оболочка с именем события event, меткой времени ISO timestamp и исходным webhook_id, содержащая объект data, структура которого зависит от события.
Объект data для события job.done содержит задание печати, принтер, файл, пользователя и прошедшее время. Событие filament.assigned содержит филамент, принтер и инструмент, которому он назначен. Событие maintenance.job_overdue содержит задание, принтер, ответственного пользователя и исходную дату выполнения. Оболочка одна, данные зависят от события, поэтому одно выражение switch в вашем коде обрабатывает весь поток.
Узнайте, как Weshape использует Вебхуки для управления парком ~50 printers
Order queueing is a webhook that feeds into the SimplyPrint API.
Тестируйте, анализируйте и проверяйте перед запуском в производство
Webhooks должны быть простыми. SimplyPrint даёт три инструмента, чтобы так и было: посмотрите, что получите, отправьте тестовый запрос и просмотрите все уже выполненные доставки.
Отправить тестовое событие
Отправляйте payload с реальной структурой по запросу из любой подписки.
Примеры полезных нагрузок
Изучите точные структуры payload перед написанием кода.
История доставок
URL, HTTP-статус, тело ответа и метка времени для каждой доставки.
Как выглядят ваши webhooks после доставки
Форматы Discord, Slack и Teams отображаются в этих приложениях как встроенные карточки: расширенный заголовок, поля полезной нагрузки и необязательная миниатюра принтера. Вот три реальных сообщения с фермы печати, работающей с SimplyPrint, полученные непосредственно из канала Discord. Настройте формат один раз, а SimplyPrint сам сформирует карточку.
Просроченное техобслуживание
Запланированное задание по техобслуживанию просрочено: название задания, принтер, приоритет, расписание и группа, всё в одной карточке.
Задание по техобслуживанию создано
Запланировано новое задание по техобслуживанию, принтер, группа и приоритет сразу появляются в канале вашей команды.
Инвентарь запчастей
Изменения инвентаря: удаление деталей, корректировка запасов и пополнение, передаются как отдельные события, чтобы инструмент автоматизации мог реагировать на каждое из них.
Необязательная проверка секрета, чтобы подтвердить, что запрос действительно пришёл от SimplyPrint
Задайте секрет для каждого вебхука, и SimplyPrint будет отправлять его с каждой доставкой в заголовке X-SP-Secret, чтобы ваш обработчик мог убедиться, что запрос действительно пришёл от нас, а не с произвольного IP, который угадал ваш URL. Не указывайте секрет для вебхуков во внутренней сети, если он не нужен. Меняйте его при утечке ключа, прошлые доставки останутся действительными, а будущие будут использовать новый ключ.
Каждый вебхук также можно независимо включить или отключить: переключателем можно приостановить шумную интеграцию, не теряя её подписку на события и историю.
Что люди на самом деле подключают
Это самые распространённые сценарии, которые встречаются на фермах 3D-печати, в школах, мейкерспейсах и продуктовых командах, использующих SimplyPrint.
Отправляйте job.done и job.failed в канал команды.
Запускайте выставление счетов или выполнение заказа после одобрения элемента очереди.
Оповещайте команду эксплуатации о просроченном техобслуживании или малом запасе запчастей.
Показывайте учителям отправленные учащимися работы в реальном времени.
Push-часть полноценного решения для разработчиков
Webhooks естественно сочетаются с остальными инструментами разработчика SimplyPrint:
- SimplyPrint API позволяет коду запрашивать любые данные состояния по требованию: принтеры, очередь, файлы, филамент, задания.
- Webhooks позволяют SimplyPrint отправлять события сразу при изменениях, поэтому опрос не требуется.
- SimplyPrint MCP server позволяет ИИ-помощникам, включая Claude и ChatGPT, читать данные того же парка принтеров и выполнять действия через проверенный реестр инструментов.
Доступность в планах: какие планы включают вебхуки?
Webhooks включены в тарифы Print Farm и Enterprise без доплаты. Никаких сборов за Webhook или доставку и никаких ограничений на события.
| Функция / ограничение | Free | Базовый | Pro | Ферма печати | Enterprise | Школа | Облачный слайсер | Менеджер филамента |
|---|---|---|---|---|---|---|---|---|
|
Вебхуки
Полная многоканальная система вебхуков: обычный JSON, Discord, Slack и Microsoft Teams, полный каталог событий, опциональная проверка секрета и история каждой доставки.
|
Хотите узнать больше о наших тарифах?
Посмотреть все цены и сравнение функцийЧасто задаваемые вопросы
Как отправлять события в Discord, Slack или Microsoft Teams?
discord.com/api/webhooks, hooks.slack.com/services или URL рабочего процесса Teams, и формируем сообщение в нативном для неё формате. Без установки бота, приложения и промежуточного ПО.На какие события можно подписаться?
Как убедиться, что запрос действительно пришёл от SimplyPrint?
Можно ли увидеть, что было доставлено?
Можно ли протестировать вебхук перед запуском?
Чем это отличается от API SimplyPrint?
А если мой сервер недоступен, будут ли повторные попытки?
Повторяет ли SimplyPrint попытки доставки при сбое?
Как долго хранятся попытки доставки?
В каких тарифах доступны вебхуки?
Пошаговое руководство по настройке
Пошаговое создание первого вебхука, включая детали для URL Discord, Slack и Microsoft Teams, описано в полной статье справочного центра о вебхуках.