REST API для парка Prusa, размещённый в облаке

Prusa Prusa API

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

API genel bakışını görüntüle Ücretsiz başla Daha fazla bilgi ve kılavuz

Совместимость со всей современной линейкой 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.
  • События 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 (возможность записи для изменения очереди и запуска печати).

Özellik / sınır Ücretsiz Basic Pro Baskı çiftliği Kurumsal Okul Bulut slicer Filament yöneticisi
Запросов API в минуту
Скользящий поминутный лимит для всех API-вызовов аккаунта.
- - 60 180 600 180 - -
Доступ к Basic API
Получайте сведения о состоянии принтера, очереди, заданиях и истории для каждого принтера Prusa в аккаунте.
Расширенный API (запуск печати, отправка G-code)
Открывает загрузку файлов, операции в очереди, запускающие печать, и прямую отправку G-code.

Planlarımız hakkında daha fazla bilgi ister misiniz?

Tam fiyat ve özellik karşılaştırmasını görüntüle

Естественно сочетается с вебхуками и облачным PrusaSlicer

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

Посмотреть главную страницу API

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

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} является ID вашего аккаунта, а не версией. Найдите его в URL панели после входа. Аутентификация выполняется через один заголовок: X-API-KEY: your_key_here.
Да. Поток OAuth2 позволяет каждому владельцу Prusa подключить свой аккаунт SimplyPrint к вашему приложению через экран согласия, без общих ключей API. Полные сведения об OAuth2 и форму запроса клиента см. на главной странице API.

İçindekiler