Alternativa à API do OctoPrint
OctoPrint + SimplyPrint = uma API REST em nuvem para toda a frota
O SimplyPrint funciona junto com o OctoPrint, não substitui o OctoPrint localmente no Pi. O plugin OctoPrint do SimplyPrint conecta seus hosts OctoPrint existentes à nossa nuvem, e suas integrações de API OctoPrint nesses hosts continuam funcionando. O benefício é uma API REST para toda a frota: uma única URL base para todas as impressoras.
Uma API REST para todas as impressoras, não uma por Pi
Se você tem falado com http://pi-1.local/api/printer, http://pi-2.local/api/printer e assim por diante, conhece o problema: autenticação por host, aberturas no firewall por host, SSL por host, sem fila de impressão compartilhada, sem inventário de filamentos compartilhado. SimplyPrint substitui isso por uma API REST em nuvem para toda a frota.
# 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"
}'Como ele se conecta: o plugin OctoPrint do SimplyPrint
O SimplyPrint conecta-se a impressoras hospedadas pelo OctoPrint por meio do nosso plugin oficial para OctoPrint. Instale-o uma vez por host, o plugin vincula a impressora à sua conta SimplyPrint e, a partir daí, a impressora aparece como um objeto de impressora padrão na API SimplyPrint.
- O OctoPrint continua funcionando: sua interface OctoPrint atual, seus plugins OctoPrint atuais e suas integrações REST atuais do OctoPrint nesse host continuam funcionando.
- O SimplyPrint adiciona uma camada de frota: o painel na nuvem, a API REST na nuvem, OAuth2, webhooks, armazenamento de arquivos, fila para várias impressoras. Nada disso exige mexer na configuração do próprio OctoPrint.
- Ignorar o OctoPrint quando houver suporte: impressoras Prusa da família MK4 podem usar o pacote de firmware de código aberto do SimplyPrint, atualmente em beta, ainda sem webcam, e impressoras Klipper se conectam pelo Moonraker no host Klipper existente, em vez de usar OctoPrint. Em ambos os casos, a API as trata como o mesmo objeto de impressora.
Leia o status da impressora e envie comandos
Todos os endpoints de controle de impressora funcionam da mesma forma, seja a impressora hospedada pelo OctoPrint ou conectada por outra rota. Informe o ID da impressora e receba 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"# 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" }'O que o SimplyPrint acrescenta além da API REST do OctoPrint
A API REST do OctoPrint funciona por host e é voltada a impressoras. SimplyPrint acrescenta os recursos essenciais para frotas. Fila para várias impressoras, webhooks e histórico persistente de trabalhos são os três recursos mais usados do SimplyPrint que não existem na API REST do OctoPrint:
- Fila de impressão para várias impressoras com aprovação e roteamento: /queue/AddItem seleciona automaticamente uma impressora compatível, ou você indica uma específica. Chega de código personalizado para saber "qual Pi está livre".
- Eventos push de Webhook: SimplyPrint envia via POST eventos de fila, arquivo, impressora, trabalho e filamento para sua URL assim que ocorrem. Sem consultas recorrentes, sem eventos perdidos.
- Fluxo OAuth2 para apps parceiros: permita que outras lojas conectem a própria conta do SimplyPrint à sua ferramenta pela tela de consentimento, um padrão inviável com uma API REST do OctoPrint por host.
- Gerenciador de filamento: leia todas as bobinas da sua oficina, não só o que está carregado no hotend da impressora. Rastreamento de peso por impressão, marca, material, cor e estado de secagem.
- Endpoints de histórico de trabalhos e estatísticas: filtre trabalhos anteriores, arquive-os e obtenha dados de custo e tempo de toda a frota, não por host.
- Servidor MCP para agentes de IA: a mesma frota é disponibilizada ao Claude, ChatGPT e Gemini como uma interface de ferramentas nativa.
Migrando de uma integração REST do OctoPrint
Se você já tem código REST do OctoPrint funcionando, a migração é gradual: ambos podem funcionar lado a lado durante a transição:
- 1. Instale o plugin SimplyPrint para OctoPrint em cada host que já executa OctoPrint. O plugin não desativa o REST do OctoPrint, ambas as interfaces continuam ativas.
- 2. Gere uma chave de API SimplyPrint em configurações da conta → API.
- 3. Faça a migração de um endpoint por vez: comece com somente leitura (/printers/Get, /queue/GetItems) antes de passar para operações de gravação.
- 4. Configure webhooks para substituir qualquer padrão de listener de eventos do OctoPrint que você usava: SimplyPrint envia eventos para sua URL, em vez de executar um loop de plugin em cada Pi.
- 5. Elimine os endpoints por host quando seu código passar a ler/gravar apenas pela nuvem do SimplyPrint.
Acesso por plano à REST API em nuvem do SimplyPrint
Mesmas restrições de plano da API principal do SimplyPrint. Os planos Free e Basic não disponibilizam API; Pro e superiores liberam a API básica; Print Farm e superiores liberam a API avançada (capacidade de escrita para alterar a fila e iniciar impressões).
| Recurso / limite | Grátis | Básico | Pro | Print farm | Enterprise | Escola | Cloud Slicer | Gerenciador de filamento |
|---|---|---|---|---|---|---|---|---|
|
Solicitações de API por minuto
Limitador por minuto em janela móvel, compartilhado entre todas as chamadas de API da conta.
|
- | - | 60 | 180 | 600 | 180 | - | - |
|
Acesso à API básica
Leia o status da impressora, a fila de impressão, os trabalhos e o histórico de todas as impressoras conectadas.
|
||||||||
|
API avançada (iniciar impressões, enviar G-code)
Libera uploads de arquivos, alterações na fila que iniciam impressões e envio direto de G-code.
|
||||||||
|
Webhooks (substituem os listeners de eventos do OctoPrint)
Print Farm e superiores. Eventos push para fila de impressão, arquivos, impressoras, trabalhos de impressão e filamento.
|
Quer saber mais sobre nossos planos?
Ver preços e comparação completa de recursos