SimplyPrints 3D-printer-API

Start en utskrift med ett API-kall

Den raskeste veien fra koden din til en ekstruder i bevegelse: Send en fil-ID med POST til /queue/AddItem, velg én eller flere printere, så tar SimplyPrint seg av resten. I bakgrunnen kjører køen samme logikk for samsvar, godkjenning og ruting som panelet bruker, så utskriften starter på samme printer som den ville gjort hvis et menneske hadde trykket på Skriv ut.

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

Svar ved suksess:

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

{companyId} i URL-en er konto-ID-en din, ikke en versjon. Du finner den i panel-URL-en etter innlogging. Angi for_printers for å målrette bestemte printere, eller utelat den for å la SimplyPrint velge en kompatibel printer. Angi position: "top" for å hoppe foran i køen.

Se alle endepunkter

Les status. Send kommandoer. Samme autentiseringsheader.

List opp alle printere med ett kall. Svaret er det samme printerobjektet som panelet viser, status, aktiv jobb, temperaturer, lastet filament, alt sammen.

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

Sett en pågående utskrift på pause, send en enkeltstående G-code-linje eller kjør en akse trinnvis. Alle er sanntidsendepunkter med samme JSON-inn, JSON-ut-format.

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 for partnerintegrasjoner

Bygger du en tredjepartsapp som andre SimplyPrint-kunder skal bruke? Bruk OAuth2, slik at hver kunde kan koble til sin egen konto med en samtykkeskjerm: ingen delte API-nøkler, ingen hemmeligheter som må kopieres og limes inn. Dette er samme flyt som den offisielle Cura-integrasjonen vår bruker, og samme flyt som vi tilbyr for partnerintegrasjoner på plattformer som Zapier, n8n, Make og 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"

Godkjente OAuth2-klienter opprettes via forespørselsskjemaet for OAuth2-klienter. Send oss omdirigerings-URI-ene dine, forespurte scopes og en beskrivelse på ett avsnitt av hva appen din gjør.

Be om OAuth2-klienttilgang

Hele referansen finner du på apidocs.simplyprint.io

Hvert endepunkt, formatet på forespørsler og svar, feilkoder, OAuth2-flyten, scope-listen. Dokumentasjonen er også AI-vennlig, det finnes en llms.txt for AI-inntak i ett steg og en strukturert api/index.json hvis du vil bygge verktøy på toppen av katalogen.

Åpne API-referansen

Ofte stilte spørsmål