Les données de vos imprimantes.
Votre prochaine idée.
Exploitez les données de vos imprimantes dans des tableaux de bord, des automatisations et vos propres outils. Une API locale en lecture seule.
Une API pour imprimantes. De nombreux formats d’imprimante.
{
"printer": ...,
"state": ...,
"progress": ...
}
MQTT
PrintDeck traduit les protocoles d’imprimante pris en charge en un contrat JSON unique, versionné et en lecture seule. Développez votre logiciel une fois et utilisez la même structure avec Klipper et les imprimantes Bambu Lab prises en charge.
Votre idée, sans chaque protocole constructeur.
Laissez PrintDeck gérer la connexion propre à chaque imprimante pendant que votre application utilise un modèle de données réduit et prévisible.
Tableaux de bord locaux
Affichez la progression, les temps, les températures et l’état de la connexion sur des écrans muraux ou des panneaux d’atelier.
Passerelles Home Assistant
Injectez l’état normalisé de l’imprimante dans vos automatisations locales sans implémenter séparément MQTT et Moonraker.
Flux Node-RED
Interrogez une seule structure JSON et acheminez les événements d’imprimante vers des notifications, des éclairages ou des processus internes.
Outils de suivi
Créez des scripts et panneaux de service qui comprennent les données d’imprimante en ligne, hors ligne, périmées ou partiellement disponibles.
Des données utiles.
Aucune interface de commande.
L’API expose les informations de l’appareil, l’identité de l’imprimante, l’état, les buses et les emplacements de matériau. Elle ne peut ni démarrer, ni mettre en pause, ni annuler une impression.
GET /v1/printers/statuscurl http://PRINTDECK-IP/v1/printers/status \
-H 'Authorization: Bearer pd_your_token_here'{
"api_version": "v1",
"statuses": [{
"printer_id": 1,
"connection": {
"state": "online",
"reachability": "online",
"detail_level": "full",
"stale": false,
"updated_at_ms": 418520
},
"job": {
"phase": "printing",
"kind": "print",
"activity": "printing",
"name": "Bracket",
"progress_percent": 42.5,
"elapsed_seconds": 1260,
"remaining_seconds": 1740,
"current_layer": 48,
"total_layers": 112
}
}]
}Depuis Web Config
jusqu’à votre première requête.
- 01
Ouvrez Unified Printer API
Dans Web Config, ouvrez Paramètres de l’appareil et choisissez Unified Printer API au-dessus de Sauvegarde et restauration.
- 02
Activez et copiez le jeton
PrintDeck génère un jeton d’accès aléatoire et le stocke localement sur l’appareil.
- 03
Envoyez l’authentification Bearer
Utilisez le jeton dans l’en-tête Authorization de chaque requête adressée à l’adresse IP de PrintDeck.
- 04
Récupérez des données unifiées
Lisez les listes d’imprimantes ou leur état et utilisez la même structure JSON pour les types d’imprimantes pris en charge.
Les secrets de votre imprimante
restent derrière PrintDeck.
L’API unifiée pour imprimantes ne renvoie jamais les mots de passe d’imprimante, codes d’accès LAN, numéros de série, mots de passe Wi-Fi, images de caméra ni données brutes du constructeur. Gardez PrintDeck sur un réseau local de confiance et ne redirigez pas son port vers Internet.
Aucun webhook. Aucun relais cloud. Aucun endpoint de commande d’imprimante.
Lire le guide API completConnectez les données de l’imprimante
aux outils que vous utilisez déjà.
Chaque guide transforme Unified Printer API en une intégration locale pratique, avec des exemples fonctionnels et une procédure de configuration claire.
MQTT pour vos outils locaux
PrintDeck envoie les données normalisées des imprimantes à un serveur local tel que Mosquitto. Vos applications s’abonnent aux mises à jour au lieu d’interroger régulièrement l’API REST. HTTP et MQTT peuvent fonctionner séparément ou ensemble.
Mises à jour de l’état
Recevez l’état du travail, la progression, les températures et la disponibilité dans vos tableaux de bord ou flux Node-RED.
Événements d’impression
Réagissez aux débuts d’impression observés, aux étapes de progression et aux événements nécessitant votre attention. Les événements en direct ne sont ni conservés ni rejoués après reconnexion.
Découverte Home Assistant
Laissez Home Assistant créer automatiquement les appareils et entités avec son intégration MQTT native. Vous pouvez aussi choisir PrintDeck via HACS avec MQTT et laisser la découverte standard désactivée.