Uma API REST para sua frota Prusa, hospedada na nuvem

Prusa Prusa API

O SimplyPrint é o painel em nuvem para frotas Prusa, e a API permite que seu próprio software controle essa frota. Coloque impressões na fila de uma MK4 específica, pause um trabalho em execução na XL, envie um comando G-code para uma Mini+, obtenha o estado em tempo real de cada Prusa em sua oficina. Um cabeçalho, JSON entra, JSON sai. A mesma API funciona tanto para uma Prusa quanto para duzentas.

Ver visão geral de API Começar de graça Mais informações e guia

Compatível com toda a linha Prusa moderna

MK4, MK4S, MK3.9, MK3.5, Mini+, XL e CORE One se conectam ao SimplyPrint e expõem a mesma API. Impressoras mais antigas da classe MK3 se conectam via host OctoPrint e nosso plugin.

Enfileire uma impressão em uma Prusa específica com uma chamada de API

Envie por POST um ID de arquivo, escolha uma impressora e defina a posição. O SimplyPrint executa a impressão pela mesma lógica de fila, aprovação e roteamento usada pelo painel, para que a impressão comece na sua Prusa exatamente como começaria se uma pessoa pressionasse Imprimir.

# Queue a print on a specific Prusa MK4 (printer id 42)
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": "benchy_gcode_file_id",
    "amount": 1,
    "for_printers": "42",
    "position": "top"
  }'
Quer que o SimplyPrint escolha a Prusa mais adequada em vez de uma específica? Remova o campo for_printers, e a fila selecionará uma Prusa operacional com o volume de impressão certo e filamento carregado.

Como o SimplyPrint se conecta à sua impressora Prusa

O SimplyPrint não é um plugin do Prusa Connect. É um painel em nuvem separado que se conecta diretamente à sua Prusa, com dois caminhos de conexão, conforme a impressora que você tem:

  • MK4, MK4S, XL, MK3.9, MK3.5, Mini, Mini+, CORE One: instale uma vez na impressora o pacote de firmware de código aberto da SimplyPrint (atualmente em beta). O firmware se comunica com o SimplyPrint pelo Wi-Fi ou pela Ethernet da própria impressora, sem Pi, sem segunda caixa, sem computador host, ainda sem suporte a webcam.
  • MK3 / MK3S / MK3S+ (e anteriores): conecte via um host OctoPrint (Raspberry Pi ou similar) e nosso plugin SimplyPrint OctoPrint. A impressora se comporta de forma idêntica ao caminho de integração de firmware, da perspectiva da API.
Quando conectada, a impressora aparece como um objeto de impressora padrão na API. GET /printers/Get retorna a mesma estrutura, seja a impressora uma Prusa, Bambu Lab, Creality ou outra, para que seu código continue independente da marca, mesmo que seu hardware não seja.

Listar, inspecionar, pausar, retomar: as operações do dia a dia

Todos os endpoints de controle de impressora funcionam da mesma forma em uma Prusa e em qualquer outra impressora da sua frota. Informe o ID da impressora e receba JSON.

# List every printer in the account (Prusa, Bambu, anything)
curl "https://api.simplyprint.io/{companyId}/printers/Get" \
  -H "X-API-KEY: your_api_key_here"
Envie qualquer G-code aceito pelo seu firmware, útil para rotinas de manutenção específicas da Prusa, sequências de calibração ou correções rápidas:
# Send a one-off G-code command - home all axes on a Prusa MK4
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": 42, "gcode": "G28" }'
Pause ou retome uma impressão sem tocar no LCD da impressora:
# Pause a running print on a Prusa
curl -X POST "https://api.simplyprint.io/{companyId}/printers/actions/Pause" \
  -H "X-API-KEY: your_api_key_here" \
  -H "Content-Type: application/json" \
  -d '{ "pid": 42 }'

O que as pessoas criam com a API da Prusa

Integrações com ERP, painéis de laboratório, bots de Slack/Discord e integrações com LMS escolares são padrões comuns. Veja a página principal da API para a lista completa de casos de uso; tudo nela funciona da mesma forma com uma frota Prusa.

Por que usar SimplyPrint em vez da API do Prusa Connect?

O Prusa Connect é somente leitura em muitas visualizações: você pode monitorar, mas não iniciar impressões, gerenciar filas ou enviar G-code remotamente. SimplyPrint oferece controle completo com uma única chamada REST. O Prusa Connect é o próprio painel oficial da Prusa e expõe sua própria API, limitada. SimplyPrint oferece uma API mais ampla para as mesmas impressoras, além de recursos que o Prusa Connect não cobre:

  • Frota de várias marcas: uma API para Prusa, Bambu Lab, Creality, Anycubic, Elegoo, hosts OctoPrint e qualquer impressora baseada em Klipper. Sem alternar entre marcas.
  • Endpoints de fila, filamento e histórico de trabalhos: não apenas controle da impressora, mas inventário completo de trabalhos pendentes, estado das bobinas de filamento, estatísticas de trabalhos anteriores e campos personalizados.
  • OAuth2 para integrações de parceiros: crie uma integração que seus usuários conectem à própria conta SimplyPrint, em vez de precisarem compartilhar tokens do Prusa Connect.
  • Eventos push de Webhook: SimplyPrint envia via POST assim que uma impressão termina, sem consultas recorrentes.
SimplyPrint e Prusa Connect podem coexistir, usar ambos é tranquilo e o slicer e os envios da própria Prusa continuam funcionando em paralelo. Também precisa de fatiamento na nuvem? Veja a integração do PrusaSlicer Cloud para fatiar STL para G-code com seu próprio código antes de colocá-lo na fila.

Integração com o PrusaSlicer Cloud

Acesso por plano à API Prusa

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 Prusa da conta.
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.

Quer saber mais sobre nossos planos?

Ver preços e comparação completa de recursos

Combina naturalmente com webhooks e o PrusaSlicer na nuvem

A API Prusa é parte de uma plataforma maior para desenvolvedores. Combine-a com webhooks para eventos push quando uma Prusa concluir uma impressão e com nosso PrusaSlicer em nuvem se quiser fatiar arquivos STL em G-code com seu próprio código antes de colocá-los na fila.

Ver a página principal da API

Perguntas frequentes sobre a API da Prusa

MK4, MK4S, MK3.9, MK3.5, Mini+, Mini, XL e CORE One se conectam via pacote de firmware. Impressoras mais antigas da classe MK3, como MK3, MK3S e MK3S+, se conectam via OctoPrint e nosso plugin. Depois de conectadas, todas expõem a mesma API.
Não. O SimplyPrint é um painel separado, com sua própria conexão à sua Prusa, não um plugin do Prusa Connect. Você pode executar ambos lado a lado, se quiser, mas o SimplyPrint não requer o Prusa Connect.
Sim. Envie um POST para /queue/AddItem com for_printers: "42", o ID da impressora Prusa de destino, e a fila direcionará o trabalho a essa impressora. A impressão começa assim que a impressora estiver operacional, a menos que sua conta exija aprovação para itens da fila.
Sim, /printers/actions/SendGcode envia uma única linha de G-code para uma impressora específica. É útil para manutenção específica de impressoras Prusa, sequências de calibração ou rotinas de recuperação. O nível Enhanced da API, disponível no Print Farm e nos planos superiores, é necessário para ações de escrita.
https://api.simplyprint.io/{companyId}/{endpoint}. O {companyId} é o ID da sua conta, não uma versão. Encontre-o na URL do painel após fazer login. A autenticação usa um cabeçalho: X-API-KEY: your_key_here.
Sim. O fluxo OAuth2 permite que cada proprietário de Prusa conecte sua própria conta SimplyPrint ao seu aplicativo por uma tela de consentimento, sem chaves de API compartilhadas. Veja a página principal da API para todos os detalhes de OAuth2 e o formulário de solicitação de cliente.

Índice