Stessi dati. Stessa autenticazione. Tre interfacce per ogni modalità di sviluppo.
Scegliere l'interfaccia adatta al caso d'uso. Nelle integrazioni reali, di solito se ne combinano due: REST API per interrogare, webhook per reagire. Aggiungere il server MCP quando un assistente AI entra nel flusso. Nessun vincolo SDK, nessun protocollo proprietario, nessuna fatturazione separata.
Tre strumenti per sviluppatori, un'unica flotta
Ognuno risolve un tipo di problema diverso. È possibile usarne uno o tutti e tre. Condividono lo stesso modello di autorizzazioni per utente, le stesse strutture dati e lo stesso account.
JSON su HTTPS con un solo header X-API-KEY.
Eventi push verso qualsiasi URL, Discord, Slack o Teams.
Interfaccia nativa di strumenti per Claude, ChatGPT e altri assistenti AI.
Cosa creano davvero gli sviluppatori con SimplyPrint
Modelli ricorrenti osservati in farm di stampa, scuole, makerspace, partner OEM e fornitori di integrazioni:
- Acquisizione personalizzata dei lavori: un portale di preventivazione o un ERP che inserisce gli ordini pagati direttamente nella coda SimplyPrint tramite /queue/AddItem, con un webhook di risposta al termine della stampa. ShipStation, Shopify e portali d'ordine personalizzati si integrano così.
- Dashboard di produzione: pannello di stato formato TV o dashboard BI che interroga l'API per stato live delle stampanti, profondità della coda e produzione giornaliera. Per aggiornamenti immediati, abbinare i webhook invece di cicli di polling.
- Canali Discord, Slack e Teams: incollare l'URL webhook di un canale, selezionare gli eventi rilevanti per il team e ricevere messaggi nativi. Notifiche dell'officina senza codice.
- Assistenti IA: collega Claude, ChatGPT o Gemini tramite MCP e lascia che l'assistente approvi gli elementi della coda di stampa, trovi le bobine quasi esaurite o riepiloghi in un linguaggio semplice la cronologia delle stampe di ieri.
- Integrazioni hardware: il nuovo hardware AutoPrint, sostituzione piatti, sistemi di espulsione e modifiche a nastro, si collega tramite il framework di integrazione AutoPrint con pochi frammenti di G-code e una classe Integration.
- Distribuzioni white-label: i partner OEM usano la stessa interfaccia API per offrire un'esperienza cliente con il proprio brand basata su SimplyPrint.
OAuth2 per app e piattaforme di terze parti
Per creare un prodotto che altri clienti SimplyPrint collegheranno al proprio account, usare OAuth2 anziché chiedere a ogni cliente di incollare una chiave API. Si fa clic su Connect SimplyPrint, si accede a simplyprint.io, si visualizza l'elenco esatto degli scope richiesti e si approva. Si riceve un bearer token associato all'account selezionato, senza segreti condivisi, credenziali da copiare e incollare o ticket di assistenza per chiavi API smarrite.
Questo è lo stesso flusso OAuth2 predisposto per le integrazioni partner su piattaforme come Zapier, n8n, Make e Activepieces, vedere automazione dei flussi di lavoro. Gli URL canonici sono:
- Autorizzare: simplyprint.io/panel/oauth2/authorize
- Scambio del token: simplyprint.io/api/0/oauth2/Token
- Individuazione: chiamare /account/GetUser dopo lo scambio per trovare l'account associato, poi usare /api/{companyId}/{endpoint}
Integrazioni hardware AutoPrint personalizzate
Si sviluppa hardware che automatizza la rimozione delle stampe, uno scambiatore di piastre, un meccanismo di espulsione, una modifica a nastro o un raccoglitore di pezzi? Il framework AutoPrint di SimplyPrint è il punto di integrazione. Ogni integrazione hardware registra il proprio template Gcode, un caso enum per il metodo e una classe Integration che espone metadati di marketing e la MethodDefinition utilizzata da SimplyPrint per rilevare e controllare l'hardware.
I partner esistenti includono Chitu PlateCycler, JobOx, FarmLoop e il dispositivo AutoPrint di SimplyPrint, tutti collegati tramite lo stesso framework di integrazione. Il fornitore hardware, o SimplyPrint per suo conto, fornisce una sola classe PHP e uno snippet Gcode; il framework gestisce il resto: rilevamento dei metodi, UI del pannello, inoltro della coda, Gcode di fine e rilevamento dell'espulsione. Contattare [email protected] per hardware da integrare come metodo AutoPrint nativo.
Accesso per piano: chi può usare ciascuna interfaccia per sviluppatori
Tutte e tre le interfacce per sviluppatori fanno parte dei piani standard SimplyPrint: nessuna postazione per sviluppatori separata, nessuna fatturazione per chiamata o tariffa per evento. I piani Free, Basic, Cloud Slicer e Filament Manager non espongono interfacce per sviluppatori; tutto ciò che segue è disponibile da Pro in su.
| Funktion / Limit | Kostenlos | Einfach | Pro | Druckfarm | Enterprise | Schule | Cloud Slicer | Filament-Manager |
|---|---|---|---|---|---|---|---|---|
|
Accesso API di base
Dal piano Pro. JSON su HTTPS, un'intestazione X-API-KEY. Accesso in lettura più scritture limitate: stato delle stampanti, elementi della coda, lavori, inventario del filamento, tag e gruppi. 60 richieste al minuto su Pro, 180 su Print Farm e School, 600 su Enterprise.
|
||||||||
|
API avanzata (lettura e scrittura complete)
Piano Print Farm e superiori. Consente il caricamento di file tramite /queue/AddItem, modifiche alla coda che avviano stampe, invio diretto di G-code e operazioni di scrittura in blocco. Eredita il pool di limiti di frequenza più alto del piano.
|
||||||||
|
Webhooks
Piano Print Farm e superiori. Sistema di webhook multicanale completo, JSON standard, Discord, Slack e Microsoft Teams, con oltre 60 eventi, firme HMAC facoltative e cronologia per ogni invio. Nessun costo per webhook o invio, nessun limite di eventi.
|
||||||||
|
Server MCP per assistenti AI
Dal piano Pro. È possibile collegare Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT, Gemini, Cursor e qualsiasi altro assistente compatibile con MCP per gestire la flotta in linguaggio naturale. Basato su OAuth, con ambiti di autorizzazione, senza costi per chiamata. L'abbonamento all'assistente è pagato al relativo fornitore.
|
||||||||
|
Zapier, n8n, Make e Activepieces
Dal piano Pro. È possibile connettersi tramite integrazioni ufficiali basate su OAuth2. I piani Print Farm e superiori offrono accesso completo in scrittura, poiché le integrazioni usano il livello API dell'account.
|
Möchtest du mehr über unsere Tarife erfahren?
Vollständigen Preis- und Funktionsvergleich anzeigenPer iniziare
Scegliere l'interfaccia adatta al caso d'uso e iniziare:
- REST API: accedere al pannello, aprire impostazioni account -> API, assegnare un nome a una chiave e copiarla. Quindi consultare il riferimento completo su apidocs.simplyprint.io, incluso un file llms.txt e un catalogo strutturato api/index.json per creare strumenti basati sulla documentazione stessa.
- Webhooks: aprire la pagina dei webhooks nel pannello, incollare un URL di destinazione, qualsiasi URL oppure un webhook di canale Discord / Slack / Teams, e selezionare gli eventi rilevanti. I test di consegna richiedono un clic. Guida: tutto sulla funzione webhooks.
- MCP: incollare https://simplyprint.io/api/mcp nelle impostazioni del connettore personalizzato / server MCP dell'assistente AI, completare la schermata di consenso OAuth e porre una domanda all'assistente. Procedura dettagliata: collegare SimplyPrint a qualsiasi assistente AI tramite MCP.
- App partner OAuth2: richiedere un client tramite il modulo di richiesta client OAuth2, quindi configurare l'app con gli URL sopra.
Domande frequenti
Quale piano serve per usare l'API?
L'API è versionata?
Quali sono i limiti di frequenza?
Come ottenere una chiave API?
Chiave API o OAuth2: quale usare?
API, webhook, MCP: qual è la differenza?
Sono disponibili SDK ufficiali?
È disponibile un ambiente sandbox o di test?
I dati vengono usati per addestrare un'IA?
Dove trovare aiuto in caso di difficoltà?
Guide passo passo alla configurazione
Guide complete, client per client, per ogni funzionalità sono disponibili nella sezione sviluppatori dell'helpdesk: configurazione delle chiavi API, webhook per Discord / Slack / Teams e guide alla configurazione MCP per Claude, ChatGPT e Gemini CLI.