Хмарний REST API для вашого парку Prusa

Prusa API Prusa

SimplyPrint є хмарною панеллю для парків Prusa, а API дає вашому ПЗ змогу керувати цим парком. Поставте друк у чергу на конкретному MK4, призупиніть запущене завдання на XL, надішліть команду G-code на Mini+, отримайте поточний стан кожного Prusa у вашій майстерні. Один заголовок, JSON на вході, JSON на виході. Той самий API працює як з одним Prusa, так і з двома сотнями.

Переглянути огляд API Розпочати безкоштовно Більше інформації та інструкцій

Сумісність з усією сучасною лінійкою Prusa

MK4, MK4S, MK3.9, MK3.5, Mini+, XL і CORE One підключаються до SimplyPrint і надають той самий набір API. Старіші принтери класу MK3 підключаються через хост OctoPrint і наш плагін.

Поставте друк у чергу для конкретного принтера Prusa одним викликом API

Надішліть POST-запит з ID файлу, виберіть принтер і встановіть позицію. SimplyPrint запускає друк через ту саму логіку черги, схвалення й маршрутизації, яку використовує панель, тож друк на вашому Prusa почнеться так само, ніби людина натиснула «Друкувати».

# Queue a print on a specific Prusa MK4 (printer id 42)
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": "benchy_gcode_file_id",
    "amount": 1,
    "for_printers": "42",
    "position": "top"
  }'
Хочете, щоб SimplyPrint вибирав принтер Prusa, який найкраще підходить, замість конкретного? Приберіть поле for_printers, і черга вибере справний принтер Prusa з потрібним об'ємом друку та завантаженим філаментом.

Як SimplyPrint підключається до вашого принтера Prusa

SimplyPrint не є плагіном Prusa Connect. Це окрема хмарна панель, яка підключається безпосередньо до вашого принтера Prusa, з двома способами підключення залежно від моделі:

  • MK4, MK4S, XL, MK3.9, MK3.5, Mini, Mini+, CORE One: один раз установіть на принтер пакет прошивки SimplyPrint із відкритим кодом, який зараз у бета-версії. Прошивка зв'язується із SimplyPrint через власний Wi-Fi / Ethernet принтера без Pi, другої коробки чи головного комп'ютера. Вебкамера поки не підтримується.
  • MK3 / MK3S / MK3S+ і старіші: підключаються через хост OctoPrint, Raspberry Pi або подібний, із нашим плагіном SimplyPrint для OctoPrint. З погляду API принтер поводиться так само, як шлях через інтеграцію прошивки.
Після підключення принтер відображається в API як стандартний об'єкт принтера. GET /printers/Get повертає однакову структуру для Prusa, Bambu Lab, Creality та інших принтерів, тому ваш код не залежить від бренду, навіть якщо обладнання залежить.

Перегляд списку й деталей, призупинення та відновлення: щоденні операції

Кожна кінцева точка керування принтером однаково працює з Prusa та будь-яким іншим принтером парку. Передайте ID принтера й отримайте JSON.

# List every printer in the account (Prusa, Bambu, anything)
curl "https://api.simplyprint.io/{companyId}/printers/Get" \
  -H "X-API-KEY: your_api_key_here"
Надсилайте будь-який G-code, який підтримує ваша прошивка. Це корисно для процедур обслуговування Prusa, послідовностей калібрування або швидких виправлень:
# Send a one-off G-code command - home all axes on a Prusa MK4
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": 42, "gcode": "G28" }'
Призупиніть або відновіть друк, не торкаючись LCD принтера:
# Pause a running print on a Prusa
curl -X POST "https://api.simplyprint.io/{companyId}/printers/actions/Pause" \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "pid": 42 }'

Що створюють за допомогою API Prusa

Інтеграції ERP, дашборди лабораторій, боти Slack/Discord та інтеграції зі шкільними LMS - поширені сценарії. Повний список наведено на головній сторінці API; усе там так само працює з парком Prusa.

Чому SimplyPrint, а не API Prusa Connect?

Багато подань Prusa Connect доступні лише для читання: можна стежити, але не запускати друк, керувати чергами чи віддалено надсилати G-code. SimplyPrint надає повний запис одним викликом REST. Prusa Connect є власною панеллю Prusa з обмеженим API. SimplyPrint дає ширший API для тих самих принтерів і функції, яких немає в Prusa Connect:

  • Парк різних брендів: один API для Prusa, Bambu Lab, Creality, Anycubic, Elegoo, хостів OctoPrint і всього на основі Klipper. Без перемикання між брендами.
  • Кінцеві точки черги, філаменту та історії завдань: не лише керування принтерами, а повний облік завдань в очікуванні, стану котушок філаменту, статистики минулих завдань і настроюваних полів.
  • OAuth2 для партнерських інтеграцій: випустіть інтеграцію, яку ваші користувачі підключатимуть до власного облікового запису SimplyPrint, без потреби ділитися токенами Prusa Connect.
  • Push-події Webhook: SimplyPrint надсилає POST-запит одразу після завершення друку, без опитування.
SimplyPrint та Prusa Connect можуть працювати одночасно, а слайсер і завантаження Prusa продовжать працювати паралельно. Потрібна також хмарна нарізка? Перегляньте хмарну інтеграцію PrusaSlicer, щоб нарізати STL у G-code зі свого коду перед додаванням до черги.

Інтеграція з PrusaSlicer Cloud

Доступ до API Prusa у планах

Такий самий доступ за тарифами, як у основному API SimplyPrint. Тарифи Free і Basic не надають API; Pro і вище відкривають Basic API; Print Farm і вище відкривають Enhanced (можливість запису для змін черги та запуску друку).

Функція / обмеження Безкоштовно Basic Pro Парк принтерів Enterprise Школа Хмарний слайсер Менеджер філаменту
Запити API за хвилину
Ковзне щохвилинне обмеження для всіх викликів API облікового запису.
- - 60 180 600 180 - -
Доступ до базового API
Зчитувати стан принтера, чергу, завдання та історію для кожного принтера Prusa в обліковому записі.
Розширений API (запуск друків, надсилання G-code)
Надає доступ до завантаження файлів, змін черги із запуском друку та прямого надсилання G-code.

Хочете дізнатися більше про наші плани?

Переглянути повне порівняння цін і функцій

Природно поєднується з вебхуками та хмарним PrusaSlicer

API Prusa є лише частиною ширших можливостей для розробників. Поєднайте його з вебхуками для push-подій, коли принтер Prusa завершує друк, і з нашим хмарним PrusaSlicer, якщо хочете нарізати STL-файли у G-code зі свого коду перед додаванням до черги.

Переглянути головну сторінку API

Поширені запитання про API Prusa

MK4, MK4S, MK3.9, MK3.5, Mini+, Mini, XL і CORE One підключаються через пакет прошивки. Старіші принтери класу MK3 (MK3, MK3S, MK3S+) підключаються через OctoPrint і наш плагін. Після підключення всі вони надають той самий набір API.
Ні. SimplyPrint це окрема панель із власним підключенням до вашого Prusa, а не плагін Prusa Connect. За потреби можна використовувати обидва одночасно, але SimplyPrint не потребує Prusa Connect.
Так. Надішліть POST до /queue/AddItem з for_printers: "42" (ID цільового принтера Prusa), і черга спрямує завдання на цей принтер. Друк почнеться, щойно принтер буде готовий до роботи, якщо для елементів черги у вашому обліковому записі не потрібне схвалення.
Так, /printers/actions/SendGcode надсилає одноразовий рядок G-code на певний принтер. Це корисно для обслуговування Prusa, послідовностей калібрування або процедур відновлення. Для дій запису потрібен рівень Enhanced API, доступний на тарифі Print Farm і вище.
https://api.simplyprint.io/{companyId}/{endpoint}. {companyId} - це ідентифікатор вашого облікового запису, а не версія; знайдіть його в URL панелі після входу. Для автентифікації потрібен один заголовок: X-API-KEY: your_key_here.
Так. Потік OAuth2 дає змогу кожному власнику Prusa підключити власний обліковий запис SimplyPrint до вашого застосунку через екран згоди без спільних API-ключів. Повні відомості OAuth2 та форму запиту клієнта див. на головній сторінці API.

Зміст