Un'API REST per una flotta Prusa, ospitata nel cloud

Prusa Prusa API

SimplyPrint è il pannello cloud per flotte Prusa e l'API consente al tuo software di controllare la flotta. Mettere in coda stampe su uno specifico MK4, mettere in pausa un lavoro in esecuzione su XL, inviare un comando G-code a una Mini+, recuperare lo stato in tempo reale di ogni Prusa nell'officina. Un solo header, JSON in entrata, JSON in uscita. La stessa API funziona sia con una Prusa sia con duecento.

Visualizza la panoramica di API Iniziare gratis Maggiori informazioni e guida

Compatibile con tutti i moderni modelli Prusa

MK4, MK4S, MK3.9, MK3.5, Mini+, XL, CORE One: tutte si collegano a SimplyPrint ed espongono le stesse API. Le stampanti MK3 meno recenti si collegano tramite host OctoPrint e il nostro plugin.

Accodare una stampa su una Prusa specifica con una chiamata API

Inviare una richiesta POST con un ID file, selezionare una stampante e impostare la posizione. SimplyPrint elabora la stampa tramite la stessa logica di coda, approvazione e instradamento usata dal pannello, così la stampa si avvia su una Prusa esattamente come se una persona avesse premuto Stampa.

# 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"
  }'
Per far selezionare a SimplyPrint la Prusa più adatta anziché una specifica, è sufficiente omettere il campo for_printers; la coda seleziona una Prusa operativa con il volume di stampa adatto e il filamento corretto già caricato.

Come SimplyPrint si connette a una stampante Prusa

SimplyPrint non è un plugin di Prusa Connect. È un pannello cloud separato che si collega direttamente alle stampanti Prusa, tramite due percorsi di connessione a seconda del modello:

  • MK4, MK4S, XL, MK3.9, MK3.5, Mini, Mini+, CORE One: installare una volta sulla stampante il pacchetto firmware open source di SimplyPrint, attualmente in beta. Il firmware comunica con SimplyPrint tramite Wi-Fi / Ethernet della stampante, senza Pi, secondo dispositivo, computer host né supporto webcam per ora.
  • MK3 / MK3S / MK3S+ e precedenti: collegamento tramite un host OctoPrint (Raspberry Pi o simile) e il plugin OctoPrint di SimplyPrint. Dal punto di vista dell'API, la stampante si comporta in modo identico al percorso di integrazione firmware.
Una volta connessa, la stampante appare come oggetto stampante standard nell'API. GET /printers/Get restituisce la stessa struttura sia per una Prusa, una Bambu Lab, una Creality o qualsiasi altra stampante, quindi il codice resta indipendente dal marchio anche quando l'hardware non lo è.

Elencare, ispezionare, mettere in pausa, riprendere: le operazioni quotidiane

Ogni endpoint di controllo stampante funziona allo stesso modo su una Prusa e su qualsiasi altra stampante della flotta. Si passa l'ID stampante e si riceve 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"
Inviare qualsiasi G-code accettato dal firmware, utile per routine di manutenzione specifiche per Prusa, sequenze di calibrazione o correzioni rapide:
# 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" }'
Mettere in pausa o riprendere una stampa senza toccare l'LCD della stampante:
# 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 }'

Cosa si crea con l'API Prusa

Integrazioni ERP, dashboard di laboratorio, bot Slack/Discord, integrazioni LMS scolastici: modelli comuni. La pagina API principale contiene l'elenco completo dei casi d'uso: tutto funziona allo stesso modo con un parco stampanti Prusa.

Perché usare SimplyPrint invece dell'API di Prusa Connect?

Prusa Connect è di sola lettura in molte viste: consente il monitoraggio, ma non l'avvio delle stampe, la gestione delle code o l'invio remoto di G-code. SimplyPrint offre l'intera superficie di scrittura con una sola chiamata REST. Prusa Connect è il pannello di prima parte di Prusa ed espone la propria superficie API, limitata. SimplyPrint offre un'API più ampia per le stesse stampanti, oltre a funzioni che Prusa Connect non copre:

  • Flotta multimarca: un'unica API per Prusa, Bambu Lab, Creality, Anycubic, Elegoo, host OctoPrint e qualsiasi sistema basato su Klipper. Niente salti tra marchi.
  • Endpoint per coda, filamento e cronologia lavori: non solo controllo stampanti: inventario completo dei lavori in attesa, stato delle bobine di filamento, statistiche dei lavori passati e campi personalizzati.
  • OAuth2 per integrazioni partner: offrire un'integrazione che gli utenti collegano al proprio account SimplyPrint, senza dover condividere token Prusa Connect.
  • Eventi push Webhook: SimplyPrint invia POST non appena termina una stampa, senza polling.
SimplyPrint e Prusa Connect possono coesistere; usarli entrambi non crea problemi e lo slicer e i caricamenti di Prusa continuano a funzionare in parallelo. Serve anche lo slicing cloud? Consultare l'integrazione cloud PrusaSlicer per sezionare STL in G-code dal proprio codice prima dell'inserimento in coda.

Integrazione cloud con PrusaSlicer

Accesso all'API Prusa per piano

Stesse limitazioni per piano della principale API SimplyPrint. I piani Free e Basic non offrono API; Pro e successivi sbloccano l'API Basic; Print Farm e successivi sbloccano Enhanced (capacità di scrittura per modificare la coda e avviare stampe).

Funzionalità / Limite Gratis Base Pro Print farm Enterprise Scuola Cloud Slicer Gestore del filamento
Richieste API al minuto
Limite mobile al minuto condiviso tra tutte le chiamate API dell'account.
- - 60 180 600 180 - -
Accesso API di base
Leggere stato della stampante, coda di stampa, lavori e cronologia di ogni Prusa dell'account.
API avanzata (avviare stampe, inviare G-code)
Consente caricamenti di file, modifiche alla coda di stampa che avviano stampe e invio diretto di G-code.

Si abbina naturalmente ai webhook e a PrusaSlicer nel cloud

L'API Prusa è parte di una più ampia piattaforma per sviluppatori. Può essere abbinata a webhook per eventi push quando una Prusa termina una stampa e al nostro PrusaSlicer cloud per sezionare file STL in G-code dal proprio codice prima di metterli in coda.

Visualizzare la pagina principale dell'API

Domande frequenti su Prusa API

MK4, MK4S, MK3.9, MK3.5, Mini+, Mini, XL e CORE One si collegano tramite il pacchetto firmware. Le stampanti MK3 meno recenti (MK3, MK3S, MK3S+) si collegano tramite OctoPrint e il nostro plugin. Una volta collegate, espongono tutte le stesse API.
No. SimplyPrint è un pannello separato con una propria connessione alla stampante Prusa, non un plugin Prusa Connect. Entrambi possono essere usati affiancati, ma SimplyPrint non richiede Prusa Connect.
Sì. Inviare POST a /queue/AddItem con for_printers: "42" (l'ID della stampante Prusa di destinazione) e la coda instrada il lavoro a quella stampante. La stampa si avvia non appena la stampante è operativa, salvo che l'account richieda l'approvazione degli elementi della coda.
Sì: /printers/actions/SendGcode invia una riga G-code una tantum a una stampante specifica. Utile per manutenzione specifica Prusa, sequenze di calibrazione o procedure di ripristino. Per le operazioni di scrittura è richiesto il livello API Enhanced, Print Farm o superiore.
https://api.simplyprint.io/{companyId}/{endpoint}. {companyId} è l'ID dell'account, non una versione, ed è disponibile nell'URL del pannello dopo l'accesso. L'autenticazione richiede un'intestazione: X-API-KEY: your_key_here.
Sì. Il flusso OAuth2 consente a ogni proprietario di Prusa di collegare il proprio account SimplyPrint all'app tramite una schermata di consenso, senza chiavi API condivise. Vedere la pagina API principale per i dettagli completi su OAuth2 e il modulo di richiesta client.

Indice dei contenuti