Alternativa all'API OctoPrint
OctoPrint + SimplyPrint = un'API REST cloud per l'intera flotta
SimplyPrint funziona insieme a OctoPrint, non sostituisce OctoPrint localmente sul Pi. Il plugin OctoPrint di SimplyPrint collega gli host OctoPrint esistenti al cloud e le integrazioni API OctoPrint già presenti su tali host continuano a funzionare. Il vantaggio è REST per l'intera flotta: un unico URL di base per ogni stampante.
Una REST API per ogni stampante, non una per Pi
Se oggi vengono usati http://pi-1.local/api/printer, http://pi-2.local/api/printer e così via, il problema è noto: autenticazione per host, aperture firewall per host, SSL per host, nessuna coda condivisa e nessun inventario di filamenti condiviso. SimplyPrint sostituisce tutto con un'unica API REST cloud per l'intera flotta.
# 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"
}'Come si connette: il plugin OctoPrint di SimplyPrint
SimplyPrint si connette alle stampanti ospitate da OctoPrint tramite il plugin ufficiale OctoPrint. Installato una volta per host, il plugin collega la stampante all'account SimplyPrint e da quel momento la stampante compare come oggetto stampante standard nell'API SimplyPrint.
- OctoPrint continua a funzionare: l'interfaccia OctoPrint esistente, i plugin OctoPrint esistenti e le integrazioni REST OctoPrint esistenti su quell'host continuano a funzionare.
- SimplyPrint aggiunge un livello per flotte: il pannello cloud, l'API REST cloud, OAuth2, webhook, archiviazione file, coda multi-stampante. Niente di tutto ciò richiede modifiche alla configurazione di OctoPrint.
- Evitare OctoPrint dove supportato: le stampanti della famiglia Prusa MK4 possono usare il pacchetto firmware open-source di SimplyPrint, attualmente in beta e senza webcam, mentre le stampanti Klipper si collegano tramite Moonraker sull'host Klipper esistente anziché OctoPrint. In entrambi i casi l'API le tratta come lo stesso oggetto stampante.
Leggere lo stato della stampante, inviare comandi
Ogni endpoint di controllo stampante funziona allo stesso modo, sia che la stampante sia ospitata da OctoPrint sia che sia connessa in altro modo. Si passa l'ID stampante e si riceve 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" }'Cosa aggiunge SimplyPrint rispetto all'API REST di OctoPrint
Il REST di OctoPrint è per host e incentrato sulla stampante. SimplyPrint aggiunge gli elementi essenziali per le flotte. Coda multi-stampante, webhook e cronologia persistente dei lavori sono le tre funzioni di SimplyPrint più usate che non esistono nell'API REST di OctoPrint:
- Coda multi-stampante con approvazione e instradamento: /queue/AddItem seleziona automaticamente una stampante compatibile, oppure è possibile indicarne una specifica. Non serve più codice su misura per sapere quale Pi è libero.
- Eventi push Webhook: SimplyPrint invia POST all'URL configurato per eventi di coda, file, stampante, lavoro di stampa e filamento non appena si verificano. Nessun polling, nessun evento perso.
- Flusso OAuth2 per app partner: consentire ad altri negozi di collegare il proprio account SimplyPrint allo strumento tramite la schermata di consenso, un modello non praticabile con REST OctoPrint per host.
- Gestore del filamento: leggere ogni bobina dell'officina, non solo quelle caricate nell'hotend della stampante. Tracciamento del peso per stampa, brand/materiale/colore, stato di essiccazione.
- Endpoint per cronologia lavori e statistiche: consentono di filtrare e archiviare i lavori passati e ottenere dati su costi e tempi dell'intero parco stampanti, non per singolo host.
- Server MCP per agenti AI: lo stesso parco stampanti esposto a Claude, ChatGPT e Gemini come strumento nativo.
Migrazione da un'integrazione REST OctoPrint
Se oggi è già in uso codice REST per OctoPrint, la migrazione può essere graduale: entrambi possono funzionare parallelamente durante il passaggio:
- 1. Installare il plugin SimplyPrint per OctoPrint su ogni host che esegue già OctoPrint. Il plugin non disabilita REST di OctoPrint, entrambe le interfacce restano attive.
- 2. Generare una chiave API SimplyPrint da impostazioni account → API.
- 3. Migrare un endpoint alla volta - iniziare con lettura sola (/printers/Get, /queue/GetItems) prima di passare alle scritture.
- 4. Collegare i webhooks per sostituire qualsiasi modello di listener eventi OctoPrint in uso, SimplyPrint invia eventi all'URL invece di eseguire un ciclo di plugin su ogni Pi.
- 5. Eliminare gli endpoint per host quando il codice legge/scrive solo tramite il cloud SimplyPrint.
Accesso alla REST API cloud SimplyPrint 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 stampante connessa.
|
||||||||
|
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.
|
||||||||
|
Webhooks (sostituiscono i listener di eventi di OctoPrint)
Piano Print Farm e superiori. Eventi push per coda, file, stampanti, lavori e filamento.
|
Vuoi saperne di più sui nostri piani?
Visualizza il confronto completo tra prezzi e funzionalità