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.
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.
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.
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.
|
Vuoi saperne di più sui nostri piani?
Visualizza il confronto completo tra prezzi e funzionalità
Alternativa a la API de OctoPrint