Альтернатива API OctoPrint
OctoPrint + SimplyPrint = хмарний REST API для всього парку
SimplyPrint працює разом з OctoPrint, він не замінює OctoPrint локально на Pi. Плагін SimplyPrint для OctoPrint підключає наявні хости OctoPrint до нашої хмари, а наявні інтеграції API OctoPrint на цих хостах продовжують працювати. Перевага в REST для всього парку: один базовий URL для кожного принтера.
Один REST API для всіх принтерів, а не окремий для кожного Pi
Якщо ви зверталися до http://pi-1.local/api/printer, http://pi-2.local/api/printer тощо, вам знайомий цей біль: автентифікація для кожного хоста, окремо відкриті порти в брандмауері, SSL для кожного хоста, немає спільної черги чи спільного обліку філаменту. SimplyPrint замінює це одним хмарним REST API для всього парку.
# Queue a print on a printer connected via the SimplyPrint OctoPrint plugin
curl -X POST "https://api.simplyprint.io/{companyId}/queue/AddItem" \
-H "X-API-KEY: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{
"fileId": "your_gcode_file_id",
"amount": 1,
"for_printers": "17",
"position": "top"
}'Як підключається: плагін SimplyPrint для OctoPrint
SimplyPrint підключається до принтерів із хостом OctoPrint через наш офіційний плагін OctoPrint. Установіть його один раз на кожному хості, плагін зв'яже принтер із вашим обліковим записом SimplyPrint, після чого принтер відображатиметься як стандартний об'єкт принтера в API SimplyPrint.
- OctoPrint продовжує працювати: ваш наявний інтерфейс OctoPrint, плагіни OctoPrint і REST-інтеграції OctoPrint на цьому хості й надалі працюють.
- SimplyPrint додає рівень керування парком принтерів: хмарну панель, хмарний REST API, OAuth2, вебхуки, сховище файлів і чергу для кількох принтерів. Усе це не потребує змін у власній конфігурації OctoPrint.
- Обходьтеся без OctoPrint там, де це підтримується: принтери сімейства Prusa MK4 можуть використовувати пакет прошивки SimplyPrint із відкритим кодом (зараз у бета-версії, поки без вебкамери), а принтери Klipper підключаються через Moonraker на наявному хості Klipper замість OctoPrint. В обох випадках API представляє їх як однаковий об'єкт принтера.
Зчитувати стан принтера, надсилати команди
Кожна кінцева точка керування принтером працює однаково незалежно від того, чи розміщено принтер в OctoPrint, чи під'єднано іншим способом. Передайте ID принтера й отримайте JSON.
# List every printer in the account - identical shape regardless of host
curl "https://api.simplyprint.io/{companyId}/printers/Get" \
-H "X-API-KEY: your_api_key_here"# Send a one-off G-code line through the SimplyPrint OctoPrint plugin
curl -X POST "https://api.simplyprint.io/{companyId}/printers/actions/SendGcode" \
-H "X-API-KEY: your_api_key_here" \
-H "Content-Type: application/json" \
-d '{ "pid": 17, "gcode": "M115" }'Що SimplyPrint пропонує понад REST API OctoPrint
REST OctoPrint працює з окремим хостом і зосереджений на принтері. SimplyPrint додає базові можливості для парку. Черга для кількох принтерів, вебхуки й постійна історія завдань є трьома найпопулярнішими можливостями SimplyPrint, яких немає в REST API OctoPrint:
- Черга кількох принтерів зі схваленням і маршрутизацією: /queue/AddItem автоматично вибирає сумісний принтер, або ви можете вказати конкретний. Більше жодного власного коду «який Pi вільний».
- Push-події Webhook: SimplyPrint надсилає POST-запити про події черги, файлів, принтерів, завдань і філаменту на ваш URL одразу після їх виникнення. Без циклів опитування, без пропущених подій.
- Потік партнерського застосунку OAuth2: дозвольте іншим майстерням підключати власні облікові записи SimplyPrint до вашого інструмента через екран згоди, це не працює з OctoPrint REST на рівні окремого хоста.
- Filament Manager: бачте кожну котушку в майстерні, а не лише завантажену в хотенд. Облік ваги кожного друку, бренд, матеріал, колір і стан сушіння.
- Кінцеві точки історії завдань і статистики: фільтруйте й архівуйте минулі завдання, отримуйте витрати й час у всьому парку, а не на окремому хості.
- Сервер MCP для агентів ШІ: той самий парк доступний Claude, ChatGPT і Gemini як власний набір інструментів.
Перехід з інтеграції OctoPrint REST
Якщо у вас уже є робочий код REST для OctoPrint, міграція відбувається поступово, обидва рішення можуть працювати паралельно, доки ви переходите:
- 1. Установіть плагін SimplyPrint для OctoPrint на кожному хості, де вже працює OctoPrint. Плагін не вимикає REST OctoPrint, обидва інтерфейси залишаються активними.
- 2. Створіть ключ API SimplyPrint у налаштуваннях облікового запису -> API.
- 3. Переносьте по одній кінцевій точці, почніть із читання (/printers/Get, /queue/GetItems), а потім переходьте до запису.
- 4. Підключіть вебхуки замість шаблону слухачів подій OctoPrint. SimplyPrint надсилає події на ваш URL замість циклу плагіна на кожному Pi.
- 5. Відмовтеся від кінцевих точок окремих хостів, коли код читатиме й записуватиме лише через хмару SimplyPrint.
Доступ до хмарного REST API SimplyPrint у планах
Такий самий доступ за тарифами, як у основному API SimplyPrint. Тарифи Free і Basic не надають API; Pro і вище відкривають Basic API; Print Farm і вище відкривають Enhanced (можливість запису для змін черги та запуску друку).
| Funkcja / limit | Za darmo | Basic | Pro | Farma druku | Enterprise | Szkoła | Slicer w chmurze | Menedżer filamentu |
|---|---|---|---|---|---|---|---|---|
|
Запити API за хвилину
Ковзне щохвилинне обмеження для всіх викликів API облікового запису.
|
- | - | 60 | 180 | 600 | 180 | - | - |
|
Доступ до базового API
Зчитувати стан принтера, чергу, завдання та історію для кожного підключеного принтера.
|
||||||||
|
Розширений API (запуск друків, надсилання G-code)
Надає доступ до завантаження файлів, змін черги із запуском друку та прямого надсилання G-code.
|
||||||||
|
Webhooks (заміна слухачів подій OctoPrint)
Тариф Print Farm і вище. Push-події для черги, файлів, принтерів, завдань і філаменту.
|
Więcej informacji o naszych planach?
Zobacz pełny cennik i porównanie funkcji