SimplyPrint 3D-printer-API'et

Start et print med ét API-kald

Den hurtigste vej fra din kode til en ekstruder i bevægelse: POST et fil-id til /queue/AddItem, vælg en eller flere printere, og SimplyPrint klarer resten. I baggrunden kører køen samme matchnings-, godkendelses- og routinglogik som panelet, så printet starter på den samme printer, som hvis et menneske havde trykket Print.

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 succes:

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

{companyId} i URL'en er dit konto-id, ikke en version. Find det i panelets URL efter login. Angiv for_printers for at målrette bestemte printere, eller udelad det for at lade SimplyPrint vælge en kompatibel printer. Angiv position: "top" for at springe frem i køen.

Gennemse alle endpoints

Læs status. Send kommandoer. Samme autentificeringsheader.

List alle printere med ét kald. Svaret er det samme printerobjekt, som panelet viser, status, aktuelt job, temperaturer, ilagt filament, det hele.

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

Sæt et kørende print på pause, send en enkelt G-code-linje, flyt en akse, alt sammen live endpoints, alle med samme JSON-ind, JSON-ud-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 til partnerintegrationer

Bygger du en tredjepartsapp, som andre SimplyPrint-kunder skal bruge? Brug OAuth2, så hver kunde kan forbinde sin egen konto med en samtykkeskærm, ingen delte API-nøgler, ingen copy-paste-hemmeligheder. Det er det samme flow, vores officielle Cura-integration bruger, og det samme flow vi opsætter til partnerintegrationer på platforme 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"

Godkendte OAuth2-klienter oprettes via OAuth2 Client Request-formularen, send os dine redirect-URI'er, ønskede scopes og en kort beskrivelse af, hvad din app gør.

Anmod om OAuth2-klientadgang

Den fulde reference findes på apidocs.simplyprint.io

Alle endpoints, request- og responseformater, fejlkoder, OAuth2-flow og scopes. Dokumentationen er også AI-venlig. Der er en llms.txt til samlet AI-indlæsning og en struktureret api/index.json, hvis du vil bygge værktøjer oven på kataloget.

Åbn API-referencen

Ofte stillede spørgsmål