Unified Printer API

Los datos de tus impresoras.
Tu próxima idea.

Usa los datos de tus impresoras en paneles, automatizaciones y tus propias herramientas. Una API local de solo lectura.

Solo red local Solo lectura por diseño Acceso con token Bearer MQTT JSON versionado
Unified Printer API

Una API de impresoras. Muchos formatos de impresora.

Bambu Lab Otro lenguaje
Creality Campos distintos
Prusa Varios formatos
Snapmaker Señales distintas
Impresoras con Klipper Otro formato de datos
Carcasa The Riverstone para PrintDeck
Los entiende todos. Te ofrece una API unificada.
GET /v1/... Un JSON {
  "printer": ...,
  "state": ...,
  "progress": ...
}
MQTT
Solo red local Solo lectura por diseño JSON versionado

PrintDeck traduce los protocolos de impresora compatibles a un único contrato JSON versionado y de solo lectura. Crea tu software una vez y lee la misma estructura desde Klipper y las impresoras Bambu Lab compatibles.

CREA SOBRE DATOS DE IMPRESORA

Tu idea, sin cada protocolo de fabricante.

Deja que PrintDeck gestione la conexión específica de cada impresora mientras tu aplicación trabaja con un modelo de datos pequeño y predecible.

01

Paneles locales

Muestra el progreso, los tiempos, las temperaturas y el estado de conexión en pantallas de pared o paneles de taller.

02

Puentes para Home Assistant

Envía el estado normalizado de la impresora a tus automatizaciones locales sin implementar MQTT y Moonraker por separado.

03

Flujos de Node-RED

Consulta una sola estructura JSON y dirige los eventos de la impresora a notificaciones, luces o flujos internos.

04

Herramientas de monitorización

Crea scripts y paneles de servicio que entiendan datos de impresora en línea, sin conexión, obsoletos o parcialmente disponibles.

UN PEQUEÑO CONTRATO DE SOLO LECTURA

Datos útiles.
Sin superficie de control.

La API expone información del dispositivo, identidad de la impresora, estado, boquillas y ranuras de material. No puede iniciar, pausar ni cancelar una impresión.

Primera solicitudGET /v1/printers/status
curl 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
    }
  }]
}
EMPIEZA EN TU RED LOCAL

Desde Web Config
hasta tu primera solicitud.

  1. 01

    Abre Unified Printer API

    En Web Config, abre Ajustes del dispositivo y elige Unified Printer API encima de Copia de seguridad y restauración.

  2. 02

    Activa y copia el token

    PrintDeck genera un token de acceso aleatorio y lo guarda localmente en el dispositivo.

  3. 03

    Envía autenticación Bearer

    Usa el token en la cabecera Authorization de cada solicitud a la dirección IP de PrintDeck.

  4. 04

    Obtén datos unificados

    Lee listas de impresoras o su estado y utiliza la misma estructura JSON para los tipos de impresora compatibles.

LÍMITE DE LAN DE CONFIANZA

Los secretos de tu impresora
permanecen detrás de PrintDeck.

La API unificada de impresoras nunca devuelve contraseñas de impresora, códigos de acceso LAN, números de serie, contraseñas Wi-Fi, fotogramas de cámara ni datos brutos del fabricante. Mantén PrintDeck en una red local de confianza y no reenvíes su puerto a Internet.

Sin webhooks. Sin relé en la nube. Sin endpoints de control de impresora.

Leer la guía completa de la API
CASOS DE USO

Conecta los datos de la impresora
con las herramientas que ya utilizas.

Cada guía convierte Unified Printer API en una integración local práctica, con ejemplos funcionales y un proceso de configuración claro.

MQTT para tus herramientas locales

PrintDeck envía datos normalizados de las impresoras a un servidor local como Mosquitto. Tus aplicaciones se suscriben a las actualizaciones en lugar de consultar repetidamente la API REST. HTTP y MQTT pueden funcionar por separado o juntos.

01

Actualizaciones de estado

Recibe el estado del trabajo, el progreso, las temperaturas y la disponibilidad en tus paneles o flujos de Node-RED.

02

Eventos de impresión

Reacciona a inicios de impresión observados, hitos de progreso y eventos que requieren atención. Los eventos en directo no se retienen ni se repiten tras reconectar.

03

Detección de Home Assistant

Deja que Home Assistant cree dispositivos y entidades automáticamente con su integración MQTT incorporada. O elige PrintDeck mediante HACS con MQTT y mantén desactivada la detección estándar.