Mêmes données. Même authentification. Trois interfaces adaptées à votre façon de développer.
Choisissez l’interface adaptée à votre tâche. La plupart des intégrations réelles en associent deux : l’API REST pour interroger, les webhooks pour réagir. Ajoutez le serveur MCP lorsqu’un assistant IA rejoint la boucle. Pas de dépendance à un SDK, ni protocole propriétaire, ni facturation séparée.
Trois interfaces développeur, un parc
Chacune répond à un type de besoin différent. Utilisez-en une. Utilisez les trois. Elles partagent le même modèle d’autorisations par utilisateur, les mêmes structures de données et le même compte.
JSON sur HTTPS avec un en-tête X-API-KEY.
Envoyez des événements vers n’importe quelle URL, Discord, Slack ou Teams.
Interface d’outils native pour Claude, ChatGPT et d’autres assistants IA.
Ce que les développeurs créent réellement avec SimplyPrint
Des tendances réelles que nous observons dans les fermes d’impression, les écoles et les fablabs, ainsi que chez les partenaires OEM et les fournisseurs d’intégrations :
- Saisie personnalisée des commandes : un portail de devis ou ERP qui envoie directement les commandes payées dans la file d’impression SimplyPrint via /queue/AddItem, avec un webhook envoyé à la fin de l’impression. ShipStation, Shopify et les portails de commande sur mesure se connectent ainsi.
- Tableaux de bord de production - panneau d’état grand format ou tableau de bord BI qui interroge l’API pour l’état des imprimantes en direct, la taille de la file et la production quotidienne. Associez-les à des webhooks pour des mises à jour instantanées au lieu de boucles d’interrogation.
- Connecteurs Discord, Slack et Teams : collez l’URL du webhook d’un canal, choisissez les événements utiles à l’équipe et recevez des messages natifs. Notifications d’atelier sans code.
- Assistants IA : connectez Claude, ChatGPT ou Gemini via MCP et laissez l’assistant approuver les éléments de la file d’attente, trouver les bobines presque épuisées ou résumer l’historique d’impression d’hier en langage clair.
- Intégrations matérielles : le nouveau matériel AutoPrint, changeurs de plateaux, systèmes d’éjection par poussée et modifications de convoyeur, s’intègre via le framework d’intégration AutoPrint avec quelques extraits de G-code et une classe Integration.
- Déploiements en marque blanche : les partenaires OEM utilisent la même surface d’API pour proposer une expérience client à leur marque basée sur SimplyPrint.
OAuth2 pour les applications et plateformes tierces
Vous développez un produit que d’autres clients SimplyPrint connecteront à leur compte ? Utilisez OAuth2 plutôt que de demander à chaque client de coller une clé API. Ils cliquent sur Connecter SimplyPrint, se connectent sur simplyprint.io, voient la liste exacte des portées demandées et donnent leur accord. Vous obtenez un jeton porteur associé au compte choisi, sans secrets partagés, identifiants copiés-collés ni tickets d’assistance pour des clés API perdues.
C’est le même flux OAuth2 que nous configurons pour les intégrations partenaires sur des plateformes comme Zapier, n8n, Make et Activepieces, voir l’automatisation des workflows. Les URL canoniques sont :
- Autoriser : simplyprint.io/panel/oauth2/authorize
- Échange de jeton : simplyprint.io/api/0/oauth2/Token
- Découverte : appelez /account/GetUser après l’échange pour trouver le compte associé, puis utilisez /api/{companyId}/{endpoint}
Intégrations matérielles AutoPrint personnalisées
Vous développez du matériel qui automatise le retrait des impressions, un échangeur de plateau, un mécanisme d’éjection, une modification à courroie, un récupérateur de pièces ? Le framework AutoPrint de SimplyPrint est le point d’intégration. Chaque intégration matérielle enregistre son propre modèle Gcode, un cas d’énumération pour la méthode et une classe d’intégration qui expose des métadonnées marketing ainsi que la MethodDefinition utilisée par SimplyPrint pour détecter et piloter le matériel.
Les partenaires existants incluent le Chitu PlateCycler, JobOx, FarmLoop et l’appareil AutoPrint de SimplyPrint lui-même, tous reliés par le même framework d’intégration. Le fournisseur de matériel, ou SimplyPrint en son nom, fournit une seule classe PHP et un extrait de Gcode ; le framework prend en charge le reste : découverte des méthodes, interface de l’application, transfert de la file d’impression, Gcode de fin, détection d’éjection. Contactez-nous via [email protected] si vous développez du matériel qui devrait être proposé comme méthode AutoPrint native.
Accès par forfait : qui peut utiliser chaque interface de développement
Les trois interfaces développeur font partie des offres SimplyPrint standard, sans licence développeur distincte, facturation à l’appel ni frais par événement. Les offres Free, Basic, Cloud Slicer et Filament Manager n’exposent aucune interface développeur, et toutes les fonctionnalités ci-dessous sont réservées à Pro et aux offres supérieures.
| Fonctionnalité / limite | Gratuit | Basic | Pro | Ferme d’impression | Enterprise | École | Slicer cloud | Gestionnaire de filament |
|---|---|---|---|---|---|---|---|---|
|
Accès à l’API de base
À partir de Pro. JSON via HTTPS, un en-tête X-API-KEY. Accès en lecture et écritures limitées : état des imprimantes, entrées de la file d’impression, impressions, inventaire de filament, étiquettes et groupes. 60 requêtes par minute avec Pro, 180 avec Print Farm et School, 600 avec Enterprise.
|
||||||||
|
API avancée (lecture et écriture complètes)
Print Farm et niveaux supérieurs. Autorise l’envoi de fichiers via /queue/AddItem, les modifications de file d’impression qui lancent des impressions, l’envoi direct de G-code et les opérations d’écriture groupées. Hérite du plafond de débit supérieur du plan.
|
||||||||
|
Webhooks
Print Farm et niveaux supérieurs. Système complet de webhooks multicanaux : JSON standard, Discord, Slack et Microsoft Teams, avec plus de 60 événements, signature HMAC facultative et historique par envoi. Aucun frais par webhook ou envoi, aucune limite d’événements.
|
||||||||
|
Serveur MCP pour les assistants IA
À partir de Pro. Connectez Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT, Gemini, Cursor et tout autre assistant compatible MCP pour piloter votre flotte en langage naturel. Basé sur OAuth, avec accès limité par périmètre, sans frais par appel. L’abonnement de l’assistant est payé à son fournisseur.
|
||||||||
|
Zapier, n8n, Make et Activepieces
À partir de Pro. Connectez-vous via les composants officiels basés sur OAuth2. Print Farm et les offres supérieures bénéficient d’un accès complet en écriture, car les intégrations utilisent le niveau API du compte.
|
Vous voulez en savoir plus sur nos forfaits ?
Voir tous les tarifs et comparer les fonctionnalitésPremiers pas
Choisissez l’interface adaptée à votre tâche et lancez-vous :
- API REST : connectez-vous au panneau, ouvrez paramètres du compte -> API, nommez une clé, copiez-la. Lisez ensuite la référence complète sur apidocs.simplyprint.io - avec un fichier llms.txt et un catalogue structuré api/index.json si vous souhaitez créer des outils basés sur la documentation elle-même.
- Webhooks : ouvrez la page Webhooks dans l’interface, collez une URL de destination (n’importe quelle URL ou un Webhook de canal Discord / Slack / Teams), puis sélectionnez les événements qui comptent. Les envois de test sont à un clic. Guide : tout savoir sur les webhooks.
- MCP : collez https://simplyprint.io/api/mcp dans les paramètres de connecteur personnalisé / serveur MCP de votre assistant IA, passez par l’écran de consentement OAuth, puis posez une question à l’assistant. Pas à pas : connecter SimplyPrint à n’importe quel assistant IA via MCP.
- Applications partenaires OAuth2 : demandez un client via le formulaire de demande de client OAuth2, puis configurez votre application avec les URL ci-dessus.
Questions fréquentes
De quel forfait ai-je besoin pour utiliser l’API ?
L’API est-elle versionnée ?
Quelles sont les limites de débit ?
Comment obtenir une clé API ?
Clé API ou OAuth2 : que choisir ?
API, webhooks, MCP : quelle différence ?
Existe-t-il des SDK officiels ?
Existe-t-il un bac à sable ou un environnement de test ?
Mes données servent-elles à entraîner une IA ?
Où obtenir de l’aide en cas de blocage ?
Guides de configuration pas à pas
Des guides détaillés pour chaque client et chaque interface sont disponibles dans la section développeurs du centre d’aide : configuration des clés API, configuration des webhooks pour Discord / Slack / Teams et guides de configuration MCP pour Claude, ChatGPT et Gemini CLI.