L’API d’imprimante 3D SimplyPrint

Lancer une impression avec un seul appel API

Le chemin le plus rapide entre votre code et un extrudeur en mouvement : envoyez par POST un ID de fichier à /queue/AddItem, ciblez une ou plusieurs imprimantes et SimplyPrint s’occupe du reste. En arrière-plan, la file d’impression applique la même logique de correspondance, d’approbation et de routage que le panneau, l’impression démarre donc sur la même imprimante que si quelqu’un avait appuyé sur Imprimer.

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

Réponse en cas de succès :

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

L’{companyId} dans l’URL est l’identifiant de votre compte, pas une version : trouvez-le dans l’URL du panneau après connexion. Définissez for_printers pour cibler des imprimantes précises, ou omettez-le pour laisser SimplyPrint choisir une imprimante compatible. Définissez position: "top" pour placer la tâche en tête de file.

Voir tous les endpoints

Lire l’état. Envoyer des commandes. Même en-tête d’authentification.

Listez toutes les imprimantes avec un seul appel. La réponse correspond au même objet imprimante qu’affiche l’interface, avec le statut, l’impression en cours, les températures, le filament chargé, etc.

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

Mettre en pause une impression en cours, envoyer ponctuellement une ligne G-code, déplacer un axe : toutes ces opérations sont disponibles via des points de terminaison actifs, avec le même format JSON en entrée et en sortie.

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 pour les intégrations partenaires

Vous développez une application tierce que d’autres clients SimplyPrint utiliseront ? Utilisez OAuth2 afin que chaque client puisse connecter son propre compte via un écran de consentement, sans clés API partagées ni secrets copiés-collés. C’est le même flux que notre intégration Cura officielle utilise, et celui que nous fournissons pour les intégrations de partenaires sur des plateformes comme Zapier, n8n, Make et 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"

Les clients OAuth2 approuvés sont configurés via le formulaire de demande de client OAuth2. Envoyez-nous vos URI de redirection, les portées demandées et une description en un paragraphe de votre application.

Demander l’accès client OAuth2

La documentation complète est disponible sur apidocs.simplyprint.io

Chaque point de terminaison, structure des requêtes et réponses, codes d’erreur, flux OAuth2, liste des portées. La documentation est aussi compatible avec l’IA : un llms.txt permet l’ingestion ponctuelle par une IA et un api/index.json structuré permet de créer des outils à partir du catalogue.

Ouvrir la référence de l’API

Questions fréquentes