Отримуйте, коли хочете. Надсилайте, коли це важливо.
SimplyPrint API чудово підходить, коли ваша система ставить запитання. За допомогою Webhooks SimplyPrint повідомляє вам щойно щось змінюється: без опитування, запланованих завдань і пропущених подій.
Надсилайте події замість опитування
Вебхук: це URL-адреса, яку ви передаєте SimplyPrint. Щоразу, коли у вашому обліковому записі відбувається подія, на яку ви підписалися, наприклад починається друк, завершується невдало завдання, затверджується елемент черги або запасна частина майже закінчується, SimplyPrint надсилає HTTP POST на цю URL-адресу з даними події. Без циклів опитування, балансування обмежень частоти й запитання «ми нічого не пропустили?», лише потік подій, який можна підключити до будь-якої системи з підтримкою HTTP.
Створюйте скільки завгодно вебхуків. Точно вибирайте події, на які реагує кожен. Вимикайте окремі вебхуки без видалення. Перевіряйте кожну доставку у перегляді історії. Це базовий механізм, на якому працює решта вебу, і тепер він підключений до вашого парку 3D-принтерів.
Чотири формати доставки, одна система вебхуків
SimplyPrint автоматично визначає призначення за URL і відповідно форматує дані. Вебхук для Discord надсилає повноцінне вбудоване повідомлення з кольором, полями й позначкою часу. Для Slack створюється повідомлення Slack Block Kit, для Microsoft Teams - адаптивна картка, а для всіх інших сервісів - чистий необроблений JSON, який можна обробляти на власний розсуд.
Чисте тіло POST для Zapier, n8n, Make або власного сервера.
Вставте URL вебхука каналу й отримуйте розширені вбудовані повідомлення без бота.
Нативні повідомлення Block Kit з будь-якого вхідного вебхука Slack.
Адаптивні картки, надіслані до робочого процесу Teams або URL конектора.
Усі події, які генерує ваш парк принтерів, згруповано в чіткі категорії
Підпишіть кожен вебхук лише на події, які для нього важливі. Загальний канал Discord для команди може потребувати лише завершення друку і збою друку. Автоматизація Zapier може підписатися на схвалення елемента черги. Дашборду обслуговування можуть знадобитися всі події maintenance.*. Ви вирішуєте для кожного вебхука.
- Події завдань друку - розпочато, призупинено, відновлено, скасовано, завершено, не вдалося, стіл звільнено, об'єкти пропущено
- Події принтера - стан AutoPrint, розмір сопла, матеріал, призначення / від'єднання власної мітки, стан несправності, стан AI, виявлений AI збій, хибне виявлення збою AI, максимальна кількість циклів AutoPrint
- Події організації: стан AutoPrint облікового запису, реєстрація нового користувача, користувач очікує на схвалення
- Черга друку - елемент додано, видалено, переміщено, відновлено, очікує схвалення, схвалено, відхилено, чергу очищено
- Філамент, створено, оновлено, видалено, призначено принтеру або від'єднано
- Обслуговування: роботу створено / розпочато / завершено / скасовано / прострочено / поновлено / оновлено / видалено, про проблему повідомлено / проблему вирішено, запчастину створено / оновлено / видалено, запас скориговано, низький запас, завдання виконано / пропущено, графік створено / оновлено / видалено
- Баланс: списання, повернення, поповнення, коригування
- Квота - новий запит, запит вирішено, скориговано, скинуто
Структура даних, з якою легко писати код
Кожне доставлення вебхука у звичайному форматі має однакову зовнішню структуру: оболонку з назвою події event, міткою часу ISO timestamp та вихідним ідентифікатором webhook_id, яка містить об'єкт data зі структурою відповідної події.
Об’єкт data для події job.done містить завдання друку, принтер, файл, користувача й тривалість. Подія filament.assigned містить філамент, принтер та інструмент, до якого його призначено. Подія maintenance.job_overdue містить завдання, принтер, відповідального користувача й початкову дату виконання. Формат обгортки однаковий, а дані залежать від події, тому один оператор switch у вашому коді обробляє весь потік.
Descubre cómo usa Weshape Webhooks para gestionar ~50 printers
Order queueing is a webhook that feeds into the SimplyPrint API.
Тестуйте, випробовуйте й перевіряйте перед випуском у робоче середовище
Вебхуки мають бути простими. SimplyPrint дає три інструменти, щоб так і було: перевірити, що ви отримаєте, надіслати тестовий виклик і переглянути всі вже доставлені події.
Надіслати тестову подію
Надсилайте на вимогу корисне навантаження фактичної структури з будь-якої підписки.
Приклади даних
Переглянути точні структури payload перед написанням коду.
Історія доставлення
URL, HTTP-статус, тіло відповіді та часова позначка для кожної доставки.
Вигляд доставлених вебхуків
Формати Discord, Slack і Teams відображаються в цих застосунках як нативні картки вбудовування: розширений заголовок, структуровані поля даних та необов'язкова мініатюра принтера. Ось три реальні повідомлення з друкарської ферми, яка використовує SimplyPrint, безпосередньо з каналу Discord. Налаштуйте формат один раз, а SimplyPrint подбає про вбудовану картку.
Прострочене обслуговування
Заплановану роботу з обслуговування прострочено: назва роботи, принтер, пріоритет, розклад і група, усе в одній картці.
Завдання обслуговування створено
Заплановано нову роботу з обслуговування, принтер, група й пріоритет одразу відображаються у каналі вашої команди.
Облік запасних частин
Зміни запасів, зокрема видалення деталей, коригування кількості та поповнення, надсилаються як окремі події, щоб засіб автоматизації міг реагувати на кожну з них.
Необов'язкова перевірка секрету: підтвердьте, що запит справді надійшов від SimplyPrint
Установіть окремий секрет для вебхука, і SimplyPrint надсилатиме його з кожною доставкою в заголовку X-SP-Secret. Одержувач зможе перевірити, що запит справді надійшов від нас, а не з випадкової IP-адреси, яка вгадала URL. Для вебхуків внутрішньої мережі секрет можна не встановлювати. Якщо ключ витік, замініть його: минулі доставки не стануть недійсними, а майбутні використовуватимуть новий ключ.
Кожен вебхук також можна незалежно увімкнути або вимкнути. Перемкніть його, щоб призупинити надто гучну інтеграцію, не втрачаючи підписку на події чи історію.
Що люди насправді підключають
Це найпоширеніші сценарії, які ми бачимо серед ферм друку, шкіл, мейкерспейсів і команд продуктів, що використовують SimplyPrint.
Надсилайте job.done і job.failed до каналу своєї команди.
Запускайте виставлення рахунків або виконання замовлення, коли елемент черги друку схвалено.
Сповіщайте операторів про прострочене обслуговування або низький запас деталей.
Показуйте вчителям учнівські подання в реальному часі.
Push-частина повного набору інструментів для розробників
Webhooks природно поєднуються з іншими інструментами SimplyPrint для розробників:
- SimplyPrint API дає змогу коду отримувати за запитом будь-які дані про принтери, чергу, файли, філамент і завдання.
- Webhooks дають SimplyPrint змогу надсилати події щойно щось змінюється, щоб не доводилося регулярно опитувати.
- Сервер SimplyPrint MCP дає ШІ-помічникам (Claude, ChatGPT) змогу читати дані й керувати тим самим парком через перевірений реєстр інструментів.
Доступ у планах: які плани містять вебхуки?
Webhooks включено до планів Print Farm та Enterprise без додаткової плати. Немає плати за Webhook або доставку, а також обмежень на кількість подій.
| Función / límite | Gratis | Básico | Pro | Granja de impresión | Enterprise | Escuela | Cloud Slicer | Gestor de filamento |
|---|---|---|---|---|---|---|---|---|
|
Webhooks
Повна багатоканальна система вебхуків: звичайний JSON, Discord, Slack і Microsoft Teams, повний каталог подій, необов’язкова перевірка секрету та історія кожної доставки.
|
¿Quieres saber más sobre nuestros planes?
Ver precios y comparativa completa de funcionesЧасті запитання
Як надсилати події до Discord, Slack або Microsoft Teams?
discord.com/api/webhooks, hooks.slack.com/services або URL робочого процесу Teams) і сформуємо дані нативно для цієї платформи. Жодних ботів, застосунків чи проміжного ПЗ.На які події можна підписатися?
Як перевірити, що запит справді надійшов від SimplyPrint?
Чи можна побачити, що було доставлено?
Чи можна протестувати вебхук перед запуском?
Чим це відрізняється від API SimplyPrint?
А якщо мій сервер недоступний, чи будуть повторні спроби?
Чи SimplyPrint виконує повторні спроби доставлення?
Як довго зберігаються спроби доставки?
Які тарифні плани включають вебхуки?
Покроковий посібник із налаштування
Щоб дізнатися, як створити перший вебхук, зокрема подробиці URL-адрес Discord, Slack і Microsoft Teams, перегляньте повну статтю служби підтримки про вебхуки.