Mesmos dados. Mesma autenticação. Três interfaces para a forma como você desenvolve.
Escolha a interface adequada ao seu trabalho. A maioria das integrações reais combina duas delas: a REST API para consultar e webhooks para reagir. Adicione o servidor MCP quando um assistente de IA entrar no ciclo. Sem dependência de SDK, protocolo proprietário ou faturamento separado.
Três interfaces para desenvolvedores, uma frota
Cada um resolve um tipo diferente de problema. Use um. Use os três. Eles compartilham o mesmo modelo de permissões por usuário, as mesmas estruturas de dados e a mesma conta.
JSON por HTTPS com um cabeçalho X-API-KEY.
Envie eventos para qualquer URL, Discord, Slack ou Teams.
Interface nativa de ferramentas para Claude, ChatGPT e outros assistentes de IA.
O que desenvolvedores realmente criam com o SimplyPrint
Padrões reais que vemos entre print farms, escolas, makerspaces, parceiros OEM e fornecedores de integração:
- Entrada personalizada de trabalhos: um portal de orçamento ou ERP envia pedidos pagos direto para a fila do SimplyPrint via /queue/AddItem, com um webhook retornando quando a impressão termina. ShipStation, Shopify e portais de pedidos personalizados se conectam assim.
- Painéis de produção - um quadro de status para TV ou painel de BI que consulta a API para obter o estado das impressoras em tempo real, tamanho da fila e produção diária. Combine com webhooks para atualizações instantâneas em vez de consultas repetidas.
- Integrações com Discord, Slack e Teams: cole a URL do webhook de um canal, escolha os eventos importantes para a equipe e receba mensagens nativas. Notificações da oficina sem código.
- Assistentes de IA - conecte Claude, ChatGPT ou Gemini via MCP e deixe o assistente aprovar itens da fila, encontrar bobinas com estoque baixo ou resumir em linguagem simples o histórico de impressões de ontem.
- Integrações de hardware: novos equipamentos do AutoPrint, como trocadores de placas, sistemas de remoção por empurrão e modificações de correia, conectam-se pelo framework de integração do AutoPrint com alguns trechos de G-code e uma classe Integration.
- Implantações de marca branca - parceiros OEM usam a mesma superfície de API para oferecer uma experiência de cliente com sua marca sobre o SimplyPrint.
OAuth2 para apps e plataformas de terceiros
Está criando um produto para outros clientes do SimplyPrint conectarem às próprias contas? Use OAuth2 em vez de pedir que cada cliente cole uma chave de API. Eles clicam em Conectar SimplyPrint, fazem login em simplyprint.io, veem a lista exata de escopos solicitados por você e aprovam. Você recebe um token bearer vinculado à conta escolhida, sem segredos compartilhados, credenciais copiadas e coladas nem chamados de suporte sobre chaves de API perdidas.
Este é o mesmo fluxo OAuth2 que provisionamos para integrações de parceiros em plataformas como Zapier, n8n, Make e Activepieces (veja automação de fluxos de trabalho). Os URLs canônicos são:
- Autorizar: simplyprint.io/panel/oauth2/authorize
- Troca de token: simplyprint.io/api/0/oauth2/Token
- Descoberta: chame /account/GetUser após a troca para encontrar a conta vinculada e use /api/{companyId}/{endpoint}
Integrações de hardware AutoPrint personalizadas
Criando hardware que automatiza a remoção de impressões: um trocador de placas, um mecanismo de empurrar, um mod de correia, um coletor de peças? O framework AutoPrint do SimplyPrint é o ponto de integração. Cada integração de hardware registra seu próprio modelo de Gcode, um caso enum para o método e uma classe Integration que expõe metadados de marketing e a MethodDefinition que o SimplyPrint usa para descobrir e controlar o hardware.
Os parceiros existentes incluem o Chitu PlateCycler, JobOx, FarmLoop e o próprio dispositivo SimplyPrint AutoPrint, todos conectados pelo mesmo framework de integração. O fornecedor de hardware, ou o SimplyPrint em nome dele, fornece uma única classe PHP e um trecho de Gcode. O resto, descoberta de métodos, interface do painel, transferência da fila, Gcode ao terminar e detecção de ejeção, é tratado pelo framework. Fale conosco por [email protected] se estiver criando hardware que deve ser lançado como um método AutoPrint nativo.
Acesso por plano: quem pode usar cada interface de desenvolvimento
Todas as três interfaces para desenvolvedores fazem parte dos planos padrão do SimplyPrint: sem licença separada para desenvolvedores, cobrança por chamada ou taxa por evento. Os planos Free, Basic, Cloud Slicer e Filament Manager não oferecem nenhuma interface para desenvolvedores. Tudo abaixo é restrito ao Pro e superior.
| Recurso / limite | Grátis | Básico | Pro | Print farm | Enterprise | Escola | Fatiador em Nuvem | Gerenciador de filamento |
|---|---|---|---|---|---|---|---|---|
|
Acesso à API básica
No plano Pro ou superior: JSON via HTTPS, um cabeçalho X-API-KEY. Acesso de leitura e algumas operações de gravação: estado da impressora, itens da fila, trabalhos, inventário de filamento, etiquetas e grupos. 60 solicitações por minuto no Pro, 180 no Print Farm e School, 600 no Enterprise.
|
||||||||
|
API avançada (leitura e gravação completas)
Print Farm e superiores. Libera uploads de arquivos por /queue/AddItem, alterações na fila que iniciam impressões, envio direto de G-code e operações de escrita em massa. Usa o limite de taxa mais alto do plano.
|
||||||||
|
Webhooks
Print Farm e superiores. Sistema completo de webhooks multicanal: JSON padrão, Discord, Slack e Microsoft Teams, com mais de 60 eventos, assinatura HMAC opcional e histórico por entrega. Sem taxa por webhook, por entrega nem limite de eventos.
|
||||||||
|
Servidor MCP para assistentes de IA
No plano Pro ou superior, conecte Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT, Gemini, Cursor e qualquer outro assistente compatível com MCP para controlar sua frota em linguagem natural. OAuth com restrição por escopo, sem taxa por chamada. A assinatura do próprio assistente é paga ao fornecedor dele.
|
||||||||
|
Zapier, n8n, Make e Activepieces
No plano Pro ou superior, você pode se conectar usando as integrações oficiais baseadas em OAuth2. Nos planos Print Farm ou superiores, você tem acesso completo de gravação por meio delas, pois as integrações usam o nível de API da conta.
|
Quer saber mais sobre nossos planos?
Ver preços e comparação completa de recursosPrimeiros passos
Escolha a interface adequada ao seu trabalho e comece:
- API REST: entre no painel, abra configurações da conta -> API, dê um nome a uma chave e copie-a. Depois, consulte a referência completa em apidocs.simplyprint.io - incluindo um arquivo llms.txt e um catálogo estruturado api/index.json, caso queira criar ferramentas sobre a própria documentação.
- Webhooks: abra a página de webhooks no painel, cole uma URL de destino, qualquer URL ou webhook de canal do Discord / Slack / Teams, e escolha os eventos importantes. Testar entregas está a um clique. Guia: tudo sobre o recurso de webhooks.
- MCP: cole https://simplyprint.io/api/mcp nas configurações do conector personalizado/servidor MCP do seu assistente de IA, passe pela tela de consentimento OAuth e faça uma pergunta ao assistente. Passo a passo: conecte o SimplyPrint a qualquer assistente de IA via MCP.
- Apps de parceiros OAuth2: solicite um cliente pelo Formulário de solicitação de cliente OAuth2 e aponte seu app para as URLs acima.
Perguntas frequentes
De qual plano preciso para usar a API?
A API é versionada?
Quais são os limites de taxa?
Como obtenho uma chave de API?
Chave de API ou OAuth2: qual devo usar?
API, webhooks, MCP: qual é a diferença?
Há SDKs oficiais?
Há um ambiente sandbox ou de teste?
Meus dados treinam alguma IA?
Onde consigo ajuda se não conseguir avançar?
Guias de configuração passo a passo
Guias completos, cliente por cliente, para cada recurso estão na seção de desenvolvedores da central de ajuda: configuração de chave de API, configuração de webhook para Discord / Slack / Teams e guias de configuração do MCP para Claude, ChatGPT e Gemini CLI.