Una alternativa alojada a la API REST de OctoPrint, preparada para flotas

OctoPrint Alternativa a la API de OctoPrint

Si ya tienes código que se comunica con la API REST de OctoPrint, SimplyPrint te ofrece una alternativa alojada para toda la flota. Las mismas operaciones por impresora, iniciar, pausar, reanudar, enviar G-code y consultar el estado, pero disponibles para todas las impresoras de tu cuenta con una clave API, un flujo OAuth2 y una URL base. Úsalo junto a tus hosts de OctoPrint actuales mediante nuestro plugin o prescinde por completo de usar una Pi en impresoras con integración nativa en el firmware.

Visualizza la panoramica di API Iniziare gratis Maggiori informazioni e guida
Immagine della funzionalità

OctoPrint + SimplyPrint = una API REST en la nube para toda la flota

SimplyPrint funciona junto con OctoPrint, no sustituye OctoPrint localmente en el Pi. El plugin de SimplyPrint para OctoPrint conecta tus hosts OctoPrint existentes a nuestra nube, y tus integraciones de API de OctoPrint existentes en esos hosts siguen funcionando. La ventaja es REST para toda la flota: una única URL base para todas las impresoras.

Una API REST para todas las impresoras, no una por Pi

Si has estado usando http://pi-1.local/api/printer, http://pi-2.local/api/printer y así sucesivamente, conoces el problema: autenticación por host, excepciones de firewall por host, SSL por host, sin cola compartida ni inventario de filamento compartido. SimplyPrint sustituye todo eso por una única API REST en la nube para toda la flota.

# 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"
  }'
El ID de la impresora es estable y se aplica a toda la flota; la máquina host que hay detrás no aparece en la API. Si mueves una impresora de una Pi a otra, el ID de la impresora no cambia.

Cómo se conecta: el plugin de SimplyPrint para OctoPrint

SimplyPrint se conecta a impresoras alojadas en OctoPrint mediante nuestro plugin oficial de OctoPrint. Instálalo una vez en cada host: el plugin vincula la impresora con tu cuenta de SimplyPrint y, a partir de entonces, la impresora aparece como un objeto de impresora estándar en la API de SimplyPrint.

  • OctoPrint sigue funcionando: tu interfaz actual de OctoPrint, tus plugins actuales de OctoPrint y tus integraciones REST actuales de OctoPrint en ese host seguirán funcionando.
  • SimplyPrint añade una capa para gestionar flotas: el panel en la nube, la API REST en la nube, OAuth2, webhooks, almacenamiento de archivos, cola de impresión para varias impresoras. Nada de ello requiere modificar la configuración propia de OctoPrint.
  • Prescindir de OctoPrint donde sea compatible: Las impresoras de la familia Prusa MK4 pueden usar el paquete de firmware de código abierto de SimplyPrint (actualmente en beta, sin webcam todavía), y las impresoras Klipper se conectan mediante Moonraker en el host de Klipper existente en lugar de OctoPrint. En ambos casos, la API las trata como el mismo objeto de impresora.

Guía de configuración del plugin
Immagine della funzionalità
Immagine della funzionalità

Consultar el estado de la impresora y enviar comandos

Cada endpoint de control de impresoras funciona igual, tanto si la impresora está alojada por OctoPrint como si se conecta de otra forma. Pasa el ID de impresora y recibe JSON.

# 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"
Envía cualquier G-code que acepte tu firmware. Es útil para que las automatizaciones existentes de OctoPrint basadas en G-code sigan funcionando con 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" }'

Qué añade SimplyPrint a la API REST de OctoPrint

La API REST de OctoPrint es por host y se centra en una impresora. SimplyPrint añade las funciones para flotas. Cola multiimpresora, webhooks e historial de trabajos persistente son las tres capacidades de SimplyPrint más usadas que no existen en la API REST de OctoPrint:

  • Cola multiimpresora con aprobación y enrutamiento: /queue/AddItem selecciona automáticamente una impresora compatible, o puedes elegir una concreta. Ya no necesitas código personalizado para saber "qué Pi está libre".
  • Eventos push de Webhook: SimplyPrint envía mediante POST eventos de colas, archivos, impresoras, trabajos y filamento a tu URL en cuanto ocurren. Sin sondeos ni eventos perdidos.
  • Flujo OAuth2 para aplicaciones de socios: permite que otras tiendas conecten su propia cuenta de SimplyPrint a tu herramienta mediante la pantalla de consentimiento, un patrón inviable en una API REST de OctoPrint por host.
  • Gestor de filamento: lee cada bobina de tu taller, no solo la que está cargada en el hotend de la impresora. Seguimiento de peso por impresión, marca/material/color y estado de secado.
  • Endpoints de historial de trabajos y estadísticas: filtra trabajos anteriores, archívalos y consulta datos de coste y tiempo de toda la flota, no por host.
  • Servidor MCP para agentes de IA: la misma flota disponible para Claude, ChatGPT y Gemini como herramientas nativas.

Immagine della funzionalità
Immagine della funzionalità

Migrar desde una integración REST de OctoPrint

Si ya tienes código REST de OctoPrint funcionando, la migración es gradual: ambos pueden funcionar en paralelo mientras haces el cambio:

  • 1. Instala el plugin SimplyPrint para OctoPrint en cada equipo que ya ejecute OctoPrint. El plugin no desactiva la API REST de OctoPrint. Ambas interfaces siguen activas.
  • 2. Genera una clave API de SimplyPrint desde configuración de la cuenta → API.
  • 3. Migra un endpoint cada vez: empieza con operaciones de solo lectura (/printers/Get, /queue/GetItems) antes de pasar a escrituras.
  • 4. Conecta los webhooks para sustituir el patrón de escuchas de eventos de OctoPrint que usabas. SimplyPrint envía eventos a tu URL en vez de ejecutar un bucle de plugin en cada Pi.
  • 5. Elimina los endpoints por host cuando tu código lea y escriba solo mediante la nube de SimplyPrint.
¿Necesitas ayuda para asociar un endpoint específico de OctoPrint con su equivalente en SimplyPrint? La referencia completa de la API enumera cada endpoint con ejemplos.

Acceso según el plan para la API REST en la nube de SimplyPrint

Mismas limitaciones por plan que la API principal de SimplyPrint. Los planes Free y Basic no incluyen API; Pro y superiores desbloquean la API básica; Print Farm y superiores desbloquean la API mejorada (capacidad de escritura para modificar la cola e iniciar impresiones).

Funzionalità / Limite Gratis Base Pro Print farm Enterprise Scuola Cloud Slicer Gestore del filamento
Solicitudes API por minuto
Limitador con ventana móvil de un minuto compartido por todas las llamadas a la API de la cuenta.
- - 60 180 600 180 - -
Acceso básico a la API
Consulta el estado de la impresora, la cola, los trabajos y el historial de cada impresora conectada.
API avanzada (iniciar impresiones, enviar G-code)
Permite subir archivos, modificar la cola para iniciar impresiones y enviar G-code directamente.
Webhooks (sustituyen los listeners de eventos de OctoPrint)
Print Farm y superiores. Eventos push para cola, archivos, impresoras, trabajos y filamento.

Preguntas frecuentes sobre la alternativa a OctoPrint

No. El plugin de SimplyPrint para OctoPrint se ejecuta dentro de OctoPrint, por lo que OctoPrint sigue funcionando con normalidad. La ventaja es que la API en la nube de SimplyPrint expone todas las impresoras de la flota mediante una URL base, en lugar de que tengas que comunicarte con cada Pi por separado.
Sí. El plugin de SimplyPrint funciona junto a cualquier otro plugin de OctoPrint que tengas instalado. No se elimina la interfaz de OctoPrint ni su API REST, ambas siguen funcionando.
Si tus impresoras son compatibles, puedes prescindir de OctoPrint y usar otra vía: la familia Prusa MK4 mediante el paquete de firmware de código abierto de SimplyPrint (beta, aún sin webcam), o Klipper mediante Moonraker en el host Klipper actual. Las impresoras Bambu Lab se conectan mediante el puente SimplyPrint Bambu Lab Client en una Raspberry Pi o un mini PC. En ambos casos, la API trata la impresora igual.
SimplyPrint asigna un ID numérico estable a una impresora cuando se conecta por primera vez. El ID se guarda en la cuenta de SimplyPrint, no en el host, por lo que mover una impresora de un Pi a otro no cambia el ID de impresora que usa tu código de API.
Sí, esa es la ruta de migración recomendada. Instala el plugin de SimplyPrint, migra un endpoint cada vez y mantén activa la interfaz REST de OctoPrint hasta que confíes en la ruta de código de SimplyPrint.
Sí. El flujo OAuth2 permite que cada tienda conecte su propia cuenta de SimplyPrint a tu app mediante una pantalla de consentimiento, sin claves API compartidas. Consulta la página principal de la API para conocer los detalles de OAuth2 y el formulario de solicitud de cliente.

Indice dei contenuti