A API de impressoras 3D do SimplyPrint

Inicie uma impressão com uma chamada de API

O caminho mais rápido do seu código para uma extrusora em movimento: envie por POST um ID de arquivo para /queue/AddItem, escolha uma ou mais impressoras, e a SimplyPrint cuida do resto. Nos bastidores, a fila usa a mesma lógica de correspondência, aprovação e roteamento do painel, então a impressão começa na mesma impressora em que começaria se alguém pressionasse Imprimir.

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": "abc123",
    "amount": 1,
    "for_printers": "42,43",
    "position": "top"
  }'

Resposta em caso de sucesso:

{
  "status": true,
  "message": null,
  "approval_status": "not_required",
  "id": 90817,
  "queue_position": 1
}

O {companyId} na URL é o ID da sua conta, não uma versão. Encontre-o na URL do painel após entrar. Defina for_printers para selecionar impressoras específicas ou omita-o para que SimplyPrint escolha uma compatível. Defina position: "top" para ir ao topo da fila.

Explorar todos os endpoints

Leia o status. Envie comandos. Mesmo cabeçalho de autenticação.

Liste todas as impressoras com uma chamada. A resposta é o mesmo objeto de impressora exibido pelo painel: status, trabalho atual, temperaturas, filamento carregado, tudo.

curl "https://api.simplyprint.io/{companyId}/printers/Get" \
  -H "X-API-KEY: your_api_key_here"

Pause uma impressão em andamento, envie uma linha avulsa de G-code, mova um eixo: todos os endpoints são em tempo real e têm o mesmo formato de JSON de entrada e saída.

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 }'

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 X Y" }'

OAuth2 para integrações de parceiros

Está criando um app de terceiros que outros clientes do SimplyPrint usarão? Use OAuth2 para que cada cliente conecte a própria conta por uma tela de consentimento, sem chaves de API compartilhadas nem segredos copiados e colados. Este é o mesmo fluxo que nossa integração oficial com Cura usa e o que disponibilizamos para integrações de parceiros em plataformas como Zapier, n8n, Make e Activepieces.

# 1) Send the user to the consent screen
https://simplyprint.io/panel/oauth2/authorize
  ?response_type=code
  &client_id=YOUR_CLIENT_ID
  &redirect_uri=https://your-app.example.com/callback
  &scope=printers.read+queue.write+files.read
  &state=<random>

# 2) Exchange the returned code for an access token
curl -X POST "https://simplyprint.io/api/0/oauth2/Token" \
  -d "grant_type=authorization_code" \
  -d "code=AUTH_CODE_FROM_CALLBACK" \
  -d "client_id=YOUR_CLIENT_ID" \
  -d "client_secret=YOUR_CLIENT_SECRET" \
  -d "redirect_uri=https://your-app.example.com/callback"

# 3) Discover the bound company, then call API as that company
curl "https://simplyprint.io/api/0/account/GetUser" \
  -H "Authorization: Bearer ACCESS_TOKEN"

Clientes OAuth2 aprovados são provisionados pelo formulário de solicitação de cliente OAuth2: envie-nos seus URIs de redirecionamento, escopos solicitados e uma descrição de um parágrafo do que seu app faz.

Solicitar acesso de cliente OAuth2

A referência completa está em apidocs.simplyprint.io

Todos os endpoints, formatos de solicitação e resposta, códigos de erro, o fluxo OAuth2 e a lista de escopos. A documentação também é compatível com IA: há um llms.txt para ingestão de uma só vez por IA e um api/index.json estruturado caso você queira criar ferramentas sobre o catálogo.

Abrir a referência da API

Perguntas frequentes