La API de impresoras 3D de SimplyPrint

Inicia una impresión con una llamada a la API

El camino más rápido de tu código a un extrusor en movimiento: envía mediante POST un ID de archivo a /queue/AddItem, selecciona una o más impresoras y SimplyPrint se encarga del resto. Entre bastidores, la cola aplica la misma lógica de coincidencia, aprobación y enrutamiento que usa el panel, por lo que la impresión se inicia en la misma impresora en la que lo haría si una persona pulsara 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"
  }'

Respuesta correcta:

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

El {companyId} de la URL es el ID de tu cuenta, no una versión. Lo encontrarás en la URL del panel después de iniciar sesión. Configura for_printers para seleccionar impresoras concretas u omítelo para que SimplyPrint elija una compatible. Configura position: "top" para colocar el trabajo al principio de la cola.

Ver todos los endpoints

Consulta el estado. Envía comandos. La misma cabecera de autenticación.

Obtén todas las impresoras con una sola llamada. La respuesta es el mismo objeto de impresora que muestra el panel: estado, trabajo actual, temperaturas, filamento cargado y todo lo demás.

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

Pausa una impresión en curso, envía una línea de G-code puntual, mueve un eje: todos son endpoints en directo, con el mismo formato de entrada y salida JSON.

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 integraciones de socios

¿Estás creando una app de terceros que usarán otros clientes de SimplyPrint? Usa OAuth2 para que cada cliente pueda conectar su propia cuenta mediante una pantalla de consentimiento, sin claves API compartidas ni secretos copiados y pegados. Es el mismo flujo que usa nuestra integración oficial de Cura y el que proporcionamos para integraciones de socios en plataformas como Zapier, n8n, Make y 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"

Los clientes OAuth2 aprobados se habilitan mediante el formulario de solicitud de cliente OAuth2. Envíanos tus URI de redirección, los ámbitos solicitados y una descripción en un párrafo de lo que hace tu aplicación.

Solicitar acceso de cliente OAuth2

La referencia completa está en apidocs.simplyprint.io

Cada endpoint, formato de solicitudes y respuestas, códigos de error, flujo de OAuth2, lista de permisos. La documentación también es compatible con IA: incluye un llms.txt para la ingesta puntual por IA y un api/index.json estructurado si quieres crear herramientas sobre el catálogo.

Abrir la referencia de la API

Preguntas frecuentes