L'API SimplyPrint per stampanti 3D

Avviare una stampa con una chiamata API

Il percorso più rapido dal codice a un estrusore in movimento: inviare con POST un ID file a /queue/AddItem, selezionare una o più stampanti, e SimplyPrint gestisce il resto. Dietro le quinte, la coda applica la stessa logica di abbinamento, approvazione e instradamento usata dal pannello, così la stampa parte sulla stessa stampante che sarebbe stata selezionata premendo Stampa.

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": "abc123",
    "amount": 1,
    "for_printers": "42,43",
    "position": "top"
  }'

Risposta in caso di successo:

{
  "status": true,
  "message": null,
  "approval_status": "not_required",
  "id": 90817,
  "queue_position": 1
}

Il valore {companyId} nell'URL è l'ID dell'account, non una versione: si trova nell'URL del pannello dopo l'accesso. Imposta for_printers per indirizzare stampanti specifiche oppure omettilo per lasciare che SimplyPrint selezioni una stampante compatibile. Imposta position: "top" per portare il lavoro in cima alla coda.

Sfogliare tutti gli endpoint

Leggere lo stato. Inviare comandi. Stesso header di autenticazione.

Elencare tutte le stampanti con una chiamata. La risposta è lo stesso oggetto stampante visualizzato nel pannello: stato, lavoro attuale, temperature, filamento caricato e tutto il resto.

curl "https://api.simplyprint.io/{companyId}/printers/Get" \
  -H "X-API-KEY: your_api_key_here"

Mettere in pausa una stampa in corso, inviare una riga G-code ad hoc, muovere un asse a incrementi: tutti gli endpoint sono in tempo reale e hanno la stessa struttura JSON in ingresso e in uscita.

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 }'

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 X Y" }'

OAuth2 per integrazioni partner

Per creare un'app di terze parti che altri clienti SimplyPrint utilizzeranno, usare OAuth2 affinché ogni cliente possa collegare il proprio account tramite una schermata di consenso, senza chiavi API condivise né segreti da copiare e incollare. È lo stesso flusso usato dalla nostra integrazione ufficiale Cura e predisposto per le integrazioni dei partner su piattaforme come Zapier, n8n, Make e Activepieces.

# 1) Send the user to the consent screen
https://simplyprint.io/panel/oauth2/authorize
  ?response_type=code
  &client_id=YOUR_CLIENT_ID
  &redirect_uri=https://your-app.example.com/callback
  &scope=printers.read+queue.write+files.read
  &state=<random>

# 2) Exchange the returned code for an access token
curl -X POST "https://simplyprint.io/api/0/oauth2/Token" \
  -d "grant_type=authorization_code" \
  -d "code=AUTH_CODE_FROM_CALLBACK" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "redirect_uri=https://your-app.example.com/callback"

# 3) Discover the bound company, then call API as that company
curl "https://simplyprint.io/api/0/account/GetUser" \
  -H "Authorization: Bearer ACCESS_TOKEN"

I client OAuth2 approvati vengono configurati tramite il modulo di richiesta client OAuth2. Sono necessari gli URI di reindirizzamento, gli ambiti richiesti e una descrizione in un paragrafo della funzionalità dell'app.

Richiedere accesso client OAuth2

La documentazione completa è disponibile su apidocs.simplyprint.io

Ogni endpoint, struttura di richieste e risposte, codici di errore, flusso OAuth2, elenco degli scope. La documentazione è adatta anche all'AI: è disponibile un llms.txt per l'acquisizione AI one-shot e un api/index.json strutturato per creare strumenti basati sul catalogo.

Apri la documentazione API

Domande frequenti