SimplyPrints API för 3D-skrivare

Starta en utskrift med ett API-anrop

Den snabbaste vägen från din kod till en extruder i rörelse: skicka ett fil-ID med POST till /queue/AddItem, välj en eller flera skrivare, så tar SimplyPrint hand om resten. I bakgrunden kör kön samma matchnings-, godkännande- och routningslogik som panelen använder, så utskriften startar på samma skrivare som om en person hade tryckt 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 vid lyckat resultat:

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

{companyId} i URL:en är ditt konto-ID, inte ett versionsnummer. Du hittar det i panelens URL efter inloggning. Ange for_printers för att rikta mot särskilda skrivare, eller utelämna det så väljer SimplyPrint en kompatibel skrivare. Ange position: "top" för att lägga jobbet först i kön.

Se alla slutpunkter

Läs status. Skicka kommandon. Samma autentiseringsheader.

Lista alla skrivare med ett anrop. Svaret är samma skrivarobjekt som panelen visar: status, aktuellt jobb, temperaturer, laddat filament, alltihop.

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

Pausa en pågående utskrift, skicka en enstaka G-code-rad eller jogga en axel. Alla är API-ändpunkter för direktstyrning och använder samma format för JSON in och ut.

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 för partnerintegrationer

Bygger du en tredjepartsapp som andra SimplyPrint-kunder ska använda? Använd OAuth2 så att varje kund kan ansluta sitt eget konto via en samtyckesskärm, utan delade API-nycklar och utan hemligheter att kopiera och klistra in. Det här är samma flöde som vår officiella Cura-integration använder och samma flöde som vi tillhandahåller för partnerintegrationer på plattformar som Zapier, n8n, Make och 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"

Godkända OAuth2-klienter etableras via formuläret för OAuth2-klientförfrågan. Skicka dina omdirigerings-URI:er, begärda scopes och en beskrivning i ett stycke av vad din app gör.

Begär OAuth2-klientåtkomst

Hela referensen finns på apidocs.simplyprint.io

Alla slutpunkter, begärande- och svarsformat, felkoder, OAuth2-flöde och scope-lista. Dokumentationen är också AI-vänlig, det finns en llms.txt för AI-inläsning i ett steg och en strukturerad api/index.json om du vill bygga verktyg ovanpå katalogen.

Öppna API-referensen

Vanliga frågor