Un remplacement hébergé et adapté aux flottes pour l’API REST OctoPrint

OctoPrint Alternative à l’API OctoPrint

Si vous avez aujourd’hui du code qui communique avec l’API REST d’OctoPrint, SimplyPrint vous offre une alternative hébergée à l’échelle de toute votre flotte. Les mêmes opérations par imprimante, démarrer, mettre en pause, reprendre, envoyer du G-code, récupérer l’état, sont accessibles sur chaque imprimante de votre compte via une clé API, un flux OAuth2 et une URL de base. Utilisez cette solution en parallèle de vos hôtes OctoPrint existants via notre plugin, ou dispensez-vous entièrement du Pi sur les imprimantes avec intégration au firmware.

查看API概览 免费开始使用 更多信息和操作指南
功能图像

OctoPrint + SimplyPrint = une API REST cloud pour toute votre flotte

SimplyPrint fonctionne aux côtés d’OctoPrint, il ne remplace pas OctoPrint localement sur le Pi. Le plugin SimplyPrint pour OctoPrint connecte vos hôtes OctoPrint existants à notre cloud, et vos intégrations API OctoPrint existantes sur ces hôtes continuent de fonctionner. L’avantage est une API REST pour tout le parc : une seule URL de base pour toutes les imprimantes.

Une seule API REST pour toutes les imprimantes, pas une par Pi

Si vous communiquez avec http://pi-1.local/api/printer, http://pi-2.local/api/printer, et ainsi de suite, vous connaissez le problème : authentification, ouvertures de pare-feu et SSL par hôte, aucune file d’impression ni inventaire de filament partagés. SimplyPrint remplace cela par une API REST cloud unique pour toute la flotte.

# Queue a print on a printer connected via the SimplyPrint OctoPrint plugin
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": "your_gcode_file_id",
    "amount": 1,
    "for_printers": "17",
    "position": "top"
  }'
L’ID de l’imprimante est attribué à l’échelle de toute la flotte et reste stable ; la machine hôte n’apparaît pas dans l’API. Si vous déplacez une imprimante d’un Pi à l’autre, son ID ne change pas.

Comment se fait la connexion : le plugin SimplyPrint pour OctoPrint

SimplyPrint se connecte aux imprimantes hébergées par OctoPrint via notre plugin OctoPrint officiel. Installez-le une fois par hôte, le plugin associe l’imprimante à votre compte SimplyPrint et, ensuite, l’imprimante apparaît comme un objet imprimante standard dans l’API SimplyPrint.

  • OctoPrint continue de fonctionner : votre interface OctoPrint actuelle, vos plugins OctoPrint actuels et vos intégrations REST OctoPrint actuelles sur cet hôte restent tous opérationnels.
  • SimplyPrint ajoute une couche de gestion de flotte : le panneau cloud, l’API REST cloud, OAuth2, les webhooks, le stockage de fichiers et la file d’impression commune à plusieurs imprimantes. Aucun de ces éléments n’exige de modifier la configuration d’OctoPrint.
  • N’utilisez pas OctoPrint pour les imprimantes compatibles : les imprimantes Prusa de la gamme MK4 peuvent utiliser le bundle de firmware open source de SimplyPrint, actuellement en bêta et sans webcam pour le moment, et les imprimantes Klipper se connectent via Moonraker sur l’hôte Klipper existant au lieu d’OctoPrint. Dans les deux cas, l’API les traite comme le même objet imprimante.

Guide de configuration du plugin
功能图像
功能图像

Lire l’état de l’imprimante, envoyer des commandes

Chaque point de terminaison de contrôle d’imprimante fonctionne de la même façon, que l’imprimante soit hébergée par OctoPrint ou connectée autrement. Transmettez l’ID de l’imprimante, recevez du JSON en retour.

# List every printer in the account - identical shape regardless of host
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 maintenir vos automatisations existantes basées sur le G-code d’OctoPrint via SimplyPrint :
# Send a one-off G-code line through the SimplyPrint OctoPrint plugin
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": 17, "gcode": "M115" }'

Ce que SimplyPrint ajoute à l’API REST d’OctoPrint

L’API REST d’OctoPrint fonctionne par hôte et se concentre sur une imprimante. SimplyPrint ajoute les fonctions essentielles à la gestion d’un parc. La file d’impression multi-imprimantes, les webhooks et l’historique persistant des tâches d’impression sont les trois fonctionnalités SimplyPrint les plus utilisées qui n’existent pas dans l’API REST d’OctoPrint :

  • File multi-imprimantes avec approbation et routage : /queue/AddItem choisit automatiquement une imprimante compatible, ou vous pouvez en cibler une précise. Plus besoin de code sur mesure « quel Pi est libre ».
  • Événements push par webhook : SimplyPrint envoie par POST les événements de la file d’impression, des fichiers, des imprimantes, des impressions et du filament à votre URL dès qu’ils se produisent. Aucune boucle d’interrogation, aucun événement manqué.
  • Flux pour applications partenaires OAuth2 : permettez à d’autres boutiques de connecter leur propre compte SimplyPrint à votre outil via un écran de consentement, un modèle non viable avec une API REST OctoPrint par hôte.
  • Gestionnaire de filament : lisez chaque bobine de votre atelier, pas seulement celles chargées dans le hotend de l’imprimante. Suivi du poids par impression, marque, matériau, couleur et état de séchage.
  • Points de terminaison pour l’historique et les statistiques des impressions : filtrez les impressions passées, archivez-les, récupérez les données de coût et de durée pour toute la flotte, et non par hôte.
  • Serveur MCP pour agents d’IA : la même flotte est disponible pour Claude, ChatGPT et Gemini sous forme d’outil natif.

功能图像
功能图像

Migration depuis une intégration REST OctoPrint

Si vous avez déjà du code REST OctoPrint opérationnel, la migration est progressive, les deux peuvent fonctionner en parallèle pendant la transition :

  • 1. Installez le plugin SimplyPrint OctoPrint sur chaque hôte exécutant déjà OctoPrint. Le plugin ne désactive pas le REST d’OctoPrint : les deux interfaces restent actives.
  • 2. Générez une clé API SimplyPrint dans les paramètres du compte → API.
  • 3. Migrez un point de terminaison à la fois : commencez par la lecture seule (/printers/Get, /queue/GetItems) avant de passer aux écritures.
  • 4. Configurez les webhooks pour remplacer le mécanisme d’écoute des événements OctoPrint que vous utilisiez : SimplyPrint envoie les événements vers votre URL au lieu d’exécuter une boucle de plugin sur chaque Pi.
  • 5. Abandonnez les endpoints par hôte dès que votre code lit et écrit uniquement via le cloud SimplyPrint.
Besoin d’aide pour faire correspondre un point de terminaison OctoPrint précis à son équivalent SimplyPrint ? La référence complète de l’API répertorie chaque point de terminaison avec des exemples.

Accès par forfait : API REST cloud SimplyPrint

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).

功能/限制 免费 基础 专业版 打印农场 企业版 学校 云切片 耗材管理器
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’attente, les travaux et l’historique de chaque imprimante connectée.
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.
Webhooks (remplacent les écouteurs d’événements OctoPrint)
Print Farm et niveaux supérieurs. Événements push pour la file d’impression, les fichiers, les imprimantes, les tâches d’impression et le filament.

您想详细了解我们的套餐吗?

查看完整价格和功能对比

Questions fréquentes sur l’alternative à OctoPrint

Non. Le plugin SimplyPrint OctoPrint fonctionne dans OctoPrint, OctoPrint continue donc de fonctionner normalement. L’avantage est que l’API cloud SimplyPrint expose toutes les imprimantes de la flotte via une seule URL de base, au lieu de vous adresser à chaque Pi séparément.
Oui. Le plugin SimplyPrint fonctionne aux côtés de tous les autres plugins OctoPrint installés. L’interface OctoPrint et la surface REST ne sont pas supprimées, les deux continuent de fonctionner.
Si vos imprimantes sont prises en charge, vous pouvez abandonner OctoPrint et utiliser une autre voie : la famille Prusa MK4 via l’ensemble de firmwares open source de SimplyPrint (bêta, pas encore de webcam), ou Klipper via Moonraker sur l’hôte Klipper existant. Les imprimantes Bambu Lab passent par le pont SimplyPrint Bambu Lab Client sur un Raspberry Pi ou un mini PC. Dans tous les cas, l’API traite l’imprimante de la même façon.
SimplyPrint attribue un ID numérique stable à une imprimante lors de sa première connexion. L’ID est enregistré dans le compte SimplyPrint, pas sur l’hôte. Déplacer une imprimante d’un Pi à un autre ne change donc pas l’ID d’imprimante utilisé par votre code API.
Oui, c’est le chemin de migration recommandé. Installez le plugin SimplyPrint, migrez un point de terminaison à la fois et maintenez l’interface REST d’OctoPrint active jusqu’à ce que vous ayez confiance dans le chemin de code SimplyPrint.
Oui. Le flux OAuth2 permet à chaque atelier 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 les détails OAuth2 et le formulaire de demande client.

目录