Et REST API til din Prusa-flåde, hostet i skyen

Prusa Prusa-API

SimplyPrint er cloudpanelet til Prusa-flåder, og API'et lader din egen software styre flåden. Sæt print i kø på en bestemt MK4, sæt et kørende job på pause på XL, send en G-code-kommando til en Mini+, hent live-status for alle Prusa-printere på dit værksted. Én header, JSON ind, JSON ud. Det samme API virker, uanset om du har én Prusa eller to hundrede.

Se oversigt over API Kom gratis i gang Mere info og guide

Kompatibel med hele den moderne Prusa-serie

MK4, MK4S, MK3.9, MK3.5, Mini+, XL og CORE One forbinder alle til SimplyPrint og eksponerer den samme API-flade. Ældre MK3-printere forbinder via en OctoPrint-host og vores plugin.

Sæt et print i kø på en bestemt Prusa i ét API-kald

Send et fil-id med POST, vælg en printer, og sæt positionen. SimplyPrint kører printet gennem den samme printkø-, godkendelses- og ruteringslogik, som panelet bruger, så printet starter på din Prusa nøjagtigt som hvis en person trykkede Print.

# Queue a print on a specific Prusa MK4 (printer id 42)
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": "benchy_gcode_file_id",
    "amount": 1,
    "for_printers": "42",
    "position": "top"
  }'
Vil du have, at SimplyPrint vælger den Prusa, der passer bedst, i stedet for en bestemt? Fjern feltet for_printers, så vælger køen en driftsklar Prusa med det rette byggevolumen og filament ilagt.

Sådan opretter SimplyPrint forbindelse til din Prusa-printer

SimplyPrint er ikke et Prusa Connect-plugin. Det er et separat cloudpanel, der forbinder direkte til din Prusa med to forbindelsesmuligheder afhængigt af din printer:

  • MK4, MK4S, XL, MK3.9, MK3.5, Mini, Mini+, CORE One: installer SimplyPrints open source-firmwarepakke på printeren én gang (i øjeblikket i beta). Firmwaren kommunikerer med SimplyPrint via printerens eget Wi-Fi / Ethernet. Der kræves ingen Pi, ekstra boks eller værtscomputer, og webcam understøttes endnu ikke.
  • MK3 / MK3S / MK3S+ (og ældre): forbind via en OctoPrint-vært (Raspberry Pi eller lignende) samt vores SimplyPrint OctoPrint-plugin. Printeren opfører sig identisk med firmwareintegrationsvejen set fra API'ets perspektiv.
Når printeren er tilsluttet, vises den som et almindeligt printerobjekt i API'et. GET /printers/Get returnerer den samme datastruktur, uanset om printeren er en Prusa, en Bambu Lab, en Creality eller noget andet, så din kode forbliver mærkeuafhængig, selv når din hardware ikke er det.

Daglige handlinger: vis, tjek, sæt på pause og genoptag

Alle printerstyrings-endpoints fungerer på samme måde på en Prusa som på enhver anden printer i din flåde. Send printer-ID'et, få JSON tilbage.

# List every printer in the account (Prusa, Bambu, anything)
curl "https://api.simplyprint.io/{companyId}/printers/Get" \
  -H "X-API-KEY: your_api_key_here"
Send al G-code, som din firmware accepterer, for eksempel til Prusa-specifikke vedligeholdelsesrutiner, kalibreringssekvenser eller hurtige rettelser:
# Send a one-off G-code command - home all axes on a Prusa MK4
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" }'
Sæt et print på pause, eller genoptag det uden at røre ved printerens LCD:
# Pause a running print on a Prusa
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 }'

Hvad folk bygger med Prusa-API'et

ERP-koblinger, labdashboards, Slack/Discord-bots og LMS-integrationer til skoler er alle almindelige mønstre. Se den primære API-side for hele listen over anvendelser. Alle funktionerne fungerer på samme måde med en Prusa-flåde.

Hvorfor bruge SimplyPrint frem for Prusa Connects API?

Prusa Connect er skrivebeskyttet i mange visninger. Du kan overvåge, men ikke starte print, administrere printkøer eller sende G-code eksternt. SimplyPrint giver dig fuld skriveadgang via ét REST-kald. Prusa Connect er Prusas eget førstepartspanel og har sit eget begrænsede API. SimplyPrint giver dig et bredere API til de samme printere samt funktioner, som Prusa Connect ikke dækker:

  • Flåde på tværs af mærker: ét API til Prusa, Bambu Lab, Creality, Anycubic, Elegoo, OctoPrint-hosts og alt Klipper-baseret. Ingen jonglering mellem mærker.
  • Printkø-, filament- og jobhistorik-endpoints: ikke kun printerstyring, men fuldt overblik over ventende jobs, filamentstatus på spoler, statistik over tidligere jobs og brugerdefinerede felter.
  • OAuth2 til partnerintegrationer: udgiv en integration, som dine brugere forbinder til deres egen SimplyPrint-konto, uden at de skal dele Prusa Connect-tokens.
  • Webhook-pushhændelser: SimplyPrint sender en POST-anmodning, så snart et print afsluttes, ingen polling.
SimplyPrint og Prusa Connect kan bruges side om side, det er fint at bruge begge, og Prusas egen slicer og uploads fungerer fortsat parallelt. Har du også brug for cloud slicing? Se PrusaSlicer Cloud-integrationen for at slice STL til G-code fra din egen kode, før det sættes i printkøen.

PrusaSlicer Cloud-integration

Abonnementsadgang til Prusa API'et

Samme abonnementsbegrænsninger som for SimplyPrints primære API. Free- og Basic-abonnementer giver ikke adgang til et API; Pro og derover låser Basic API op; Print Farm og derover låser Enhanced op (skriverettigheder til køændringer og start af print).

Funktion/grænse Gratis Basic Pro Printfarm Enterprise Skole Cloud Slicer Filament Manager
API-forespørgsler pr. minut
Glidende grænse pr. minut, fælles for alle API-kald på kontoen.
- - 60 180 600 180 - -
Grundlæggende API-adgang
Læs printerstatus, kø, jobs og historik for hver Prusa på kontoen.
Udvidet API (start print, send G-code)
Giver adgang til filuploads, ændringer i printkøen, der starter print, og direkte afsendelse af G-code.

Vil du vide mere om vores abonnementer?

Se fuld pris- og funktionssammenligning

Fungerer naturligt sammen med webhooks og den cloudbaserede PrusaSlicer

Prusa API'et er én del af en større udviklerplatform. Kombinér det med webhooks til push-hændelser, når en Prusa afslutter et print, og med vores cloudbaserede PrusaSlicer, hvis du vil slice STL-filer til G-code fra din egen kode, før du lægger dem i printkøen.

Se hovedsiden for API'et

Ofte stillede spørgsmål om Prusa-API

MK4, MK4S, MK3.9, MK3.5, Mini+, Mini, XL og CORE One forbinder via firmwarepakke. Ældre MK3-printere (MK3, MK3S, MK3S+) forbinder via OctoPrint plus vores plugin. Når de er forbundet, eksponerer de alle den samme API-flade.
Nej. SimplyPrint er et separat panel med sin egen forbindelse til din Prusa, ikke et Prusa Connect-plugin. Du kan køre begge side om side, hvis du vil, men SimplyPrint kræver ikke Prusa Connect.
Ja. POST til /queue/AddItem med for_printers: "42" (printer-ID'et for den valgte Prusa-printer), så sender printkøen jobbet til den printer. Printet starter, så snart printeren er klar, medmindre din konto kræver godkendelse af køelementer.
Ja, /printers/actions/SendGcode sender en enkelt G-code-linje til en bestemt printer. Nyttigt til Prusa-specifik vedligeholdelse, kalibreringssekvenser eller gendannelsesrutiner. Enhanced API-niveauet (Print Farm og derover) kræves til skrivehandlinger.
https://api.simplyprint.io/{companyId}/{endpoint}. {companyId} er dit konto-ID, ikke en version. Find det i panelets URL, når du har logget ind. Godkendelse sker med én header: X-API-KEY: your_key_here.
Ja. OAuth2-flowet lader hver Prusa-ejer forbinde sin egen SimplyPrint-konto med din app via et samtykkeskærmbillede uden delte API-nøgler. Se den primære API-side for alle OAuth2-detaljerne og formularen til klientanmodning.

Indholdsfortegnelse