Une API REST pour votre flotte Prusa, hébergée dans le cloud

Prusa API Prusa

SimplyPrint est le tableau de bord cloud des flottes Prusa, et l’API permet à votre propre logiciel de piloter cette flotte. Vous pouvez mettre des impressions en file sur une MK4 spécifique, mettre en pause une impression en cours sur la XL, envoyer une commande G-code à une Mini+ et consulter l’état en direct de chaque Prusa de votre atelier. Un seul en-tête, JSON en entrée, JSON en sortie. La même API fonctionne que vous ayez une Prusa ou deux cents.

Voir l’aperçu de API Commencer gratuitement Plus d’infos & mode d’emploi

Compatible avec toute la gamme Prusa moderne

MK4, MK4S, MK3.9, MK3.5, Mini+, XL et CORE One se connectent toutes à SimplyPrint et exposent la même interface API. Les anciennes imprimantes de la gamme MK3 se connectent via un hôte OctoPrint et notre plugin.

Mettez une impression en file sur une Prusa spécifique en un appel API

Envoyez via POST un ID de fichier, ciblez une imprimante, définissez la position. SimplyPrint lance l’impression en appliquant la même logique de file d’impression, d’approbation et de routage que celle utilisée par l’interface, afin que l’impression démarre sur votre Prusa exactement comme si une personne appuyait sur Imprimer.

# 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"
  }'
Vous voulez que SimplyPrint sélectionne la Prusa la plus adaptée plutôt qu’une imprimante précise ? Omettez le champ for_printers, et la file d’impression sélectionne une Prusa opérationnelle avec le bon volume d’impression et le filament chargé.

Comment SimplyPrint se connecte à votre imprimante Prusa

SimplyPrint n’est pas un plugin Prusa Connect. C’est un tableau de bord cloud distinct qui se connecte directement à votre Prusa, avec deux méthodes de connexion selon votre imprimante :

  • MK4, MK4S, XL, MK3.9, MK3.5, Mini, Mini+, CORE One : installez une fois sur l’imprimante le package open source de firmware SimplyPrint (actuellement en bêta). Le firmware communique avec SimplyPrint via le Wi-Fi / Ethernet de l’imprimante, sans Pi, boîtier secondaire ni ordinateur hôte, sans prise en charge de webcam pour le moment.
  • MK3 / MK3S / MK3S+ (et antérieures) : connectez-les via un hôte OctoPrint (Raspberry Pi ou similaire) et notre plugin SimplyPrint pour OctoPrint. Du point de vue de l’API, l’imprimante se comporte comme avec l’intégration au firmware.
Une fois connectée, l’imprimante apparaît comme un objet d’imprimante standard dans l’API. GET /printers/Get renvoie la même structure, qu’il s’agisse d’une Prusa, d’une Bambu Lab, d’une Creality ou de tout autre modèle, votre code reste donc indépendant de la marque, même si votre matériel ne l’est pas.

Lister, inspecter, mettre en pause, reprendre : les opérations quotidiennes

Chaque point de terminaison de contrôle d’imprimante fonctionne de la même façon sur une Prusa que sur toute autre imprimante de votre parc. Transmettez l’ID de l’imprimante, recevez du JSON en retour.

# 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"
Envoyez tout G-code accepté par votre firmware, utile pour les procédures de maintenance propres à Prusa, les séquences d’étalonnage ou les correctifs rapides :
# 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" }'
Mettre en pause ou reprendre une impression sans toucher à l’écran LCD de l’imprimante :
# 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 }'

Ce que les utilisateurs créent avec l’API Prusa

Connecteurs ERP, tableaux de bord de laboratoire, bots Slack/Discord, intégrations LMS scolaires, ce sont des usages courants. Consultez la page principale de l’API pour la liste complète des cas d’usage, tout y fonctionne de la même manière avec une flotte Prusa.

Pourquoi utiliser SimplyPrint plutôt que l’API de Prusa Connect ?

Prusa Connect est en lecture seule dans de nombreuses vues : vous pouvez surveiller, mais pas démarrer des impressions, gérer les files d’attente ou envoyer du G-code à distance. SimplyPrint vous offre un accès complet en écriture via un seul appel REST. Prusa Connect est l’interface officielle de Prusa et expose sa propre surface API, limitée. SimplyPrint offre une API plus étendue pour les mêmes imprimantes, ainsi que ce que Prusa Connect ne couvre pas :

  • Parc multi-marque : une API pour Prusa, Bambu Lab, Creality, Anycubic, Elegoo, les hôtes OctoPrint et tout système basé sur Klipper. Plus besoin de jongler entre les marques.
  • Points de terminaison pour la file d’impression, le filament et l’historique des travaux : pas seulement le contrôle des imprimantes : inventaire complet des travaux en attente, état des bobines de filament, statistiques des travaux passés, champs personnalisés.
  • OAuth2 pour les intégrations partenaires : proposez une intégration que vos utilisateurs connectent à leur propre compte SimplyPrint, sans devoir partager leurs jetons Prusa Connect.
  • Événements push par Webhook : SimplyPrint envoie un POST dès qu’une impression se termine, sans interrogation.
SimplyPrint et Prusa Connect peuvent coexister, utiliser les deux ne pose aucun problème et le slicer et les téléversements de Prusa continuent de fonctionner en parallèle. Besoin aussi de slicing cloud ? Consultez l’intégration cloud PrusaSlicer pour slicer des STL en G-code depuis votre propre code avant de les mettre en file d’impression.

Intégration cloud de PrusaSlicer

Accès par forfait : API Prusa

Même accès par forfait que l’API SimplyPrint principale. Les forfaits Free et Basic n’exposent pas d’API ; Pro et les forfaits supérieurs débloquent l’API Basic ; Print Farm et les forfaits supérieurs débloquent Enhanced (capacité d’écriture pour modifier la file d’impression et démarrer des impressions).

Fonctionnalité / limite Gratuit Basic Pro Ferme d’impression Enterprise École Slicer cloud Gestionnaire de filament
Requêtes API par minute
Limite glissante par minute partagée entre tous les appels API du compte.
- - 60 180 600 180 - -
Accès à l’API de base
Lire l’état, la file d’impression, les travaux et l’historique de chaque imprimante Prusa du compte.
API avancée (démarrer des impressions, envoyer du G-code)
Permet l’import de fichiers, les modifications de la file d’impression déclenchant des impressions et l’envoi direct de G-code.

Vous voulez en savoir plus sur nos forfaits ?

Voir tous les tarifs et comparer les fonctionnalités

Se combine naturellement avec les webhooks et PrusaSlicer cloud

L’API Prusa n’est qu’une facette d’une plateforme développeur plus vaste. Associez-la aux webhooks pour recevoir des événements lorsqu’une Prusa termine une impression, ainsi qu’à notre PrusaSlicer cloud si vous souhaitez slicer des fichiers STL en G-code depuis votre propre code avant de les mettre en file d’attente.

Voir la page principale de l’API

Questions fréquentes sur l’API Prusa

MK4, MK4S, MK3.9, MK3.5, Mini+, Mini, XL et CORE One se connectent via un pack de firmware. Les anciennes imprimantes de la gamme MK3 (MK3, MK3S, MK3S+) se connectent via OctoPrint et notre plugin. Une fois connectées, elles proposent toutes les mêmes API.
Non. SimplyPrint est une interface distincte avec sa propre connexion à votre Prusa, pas un plugin Prusa Connect. Vous pouvez utiliser les deux en parallèle si vous le souhaitez, mais SimplyPrint ne nécessite pas Prusa Connect.
Oui. Envoyez une requête POST vers /queue/AddItem avec for_printers: "42" (l’ID de la Prusa cible) et la file d’impression affectera le travail à cette imprimante. L’impression démarrera dès que l’imprimante sera opérationnelle, sauf si votre compte exige l’approbation des éléments de la file d’impression.
Oui, /printers/actions/SendGcode envoie une ligne G-code ponctuelle à une imprimante donnée. Utile pour la maintenance propre à Prusa, les séquences de calibration ou les procédures de récupération. L’offre Enhanced API, Print Farm et supérieure, est requise pour les actions d’écriture.
https://api.simplyprint.io/{companyId}/{endpoint}. Le {companyId} est l’ID de votre compte, pas une version, vous le trouverez dans l’URL du tableau de bord après connexion. L’authentification se fait avec un seul en-tête : X-API-KEY: your_key_here.
Oui. Le flux OAuth2 permet à chaque propriétaire d’une Prusa de connecter son propre compte SimplyPrint à votre application via un écran de consentement, sans clés API partagées. Consultez la page principale de l’API pour tous les détails OAuth2 et le formulaire de demande client.

Table des matières