SimplyPrint 3D प्रिंटर API

एक API call में print शुरू करें

आपके code से moving extruder तक का सबसे तेज़ रास्ता: file ID को /queue/AddItem पर POST करें, एक या अधिक प्रिंटर target करें और बाकी SimplyPrint संभाल लेगा। पीछे कतार वही matching, approval और routing logic चलाती है जो panel इस्तेमाल करता है, इसलिए print उसी प्रिंटर पर शुरू होता है जिस पर किसी व्यक्ति के Print दबाने पर होता।

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

सफल होने पर प्रतिक्रिया:

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

URL में {companyId} आपके खाते की ID है, version नहीं। साइन-इन के बाद इसे panel URL में देखें। खास प्रिंटरों को लक्ष्य करने के लिए for_printers सेट करें, या compatible प्रिंटर चुनने के लिए इसे SimplyPrint पर छोड़ दें। कतार में ऊपर ले जाने के लिए position: "top" सेट करें।

सभी endpoint देखें

state पढ़ें। commands भेजें। वही auth header।

एक कॉल में हर प्रिंटर की सूची पाएँ। प्रतिक्रिया वही प्रिंटर ऑब्जेक्ट है जिसे पैनल दिखाता है: स्थिति, मौजूदा जॉब, तापमान, लोड किया गया filament, सब कुछ।

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

चल रहा प्रिंट रोकें, एक बार उपयोग होने वाली G-code लाइन भेजें, किसी अक्ष को जॉग करें - सभी लाइव एंडपॉइंट हैं और सभी का JSON-in, JSON-out प्रारूप समान है।

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

ऐसा third-party app बना रहे हैं जिसे अन्य SimplyPrint ग्राहक इस्तेमाल करेंगे? OAuth2 इस्तेमाल करें, ताकि हर ग्राहक consent screen से अपना खाता जोड़ सके। न shared API key, न copy-paste secret। यही flow हमारा आधिकारिक Cura integration इस्तेमाल करता है, और Zapier, n8n, Make व Activepieces जैसे platform पर partner integration के लिए हम यही provision करते हैं।

# 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"

स्वीकृत OAuth2 client, OAuth2 Client Request Form से provision किए जाते हैं। हमें अपनी redirect URI, माँगे गए scope और आपके app के काम का एक paragraph विवरण भेजें।

OAuth2 client access request करें

पूरा रेफ़रेंस apidocs.simplyprint.io पर उपलब्ध है

हर endpoint, रिक्वेस्ट और रिस्पॉन्स संरचना, एरर कोड, OAuth2 फ्लो, स्कोप सूची। docs AI-अनुकूल भी हैं, एक बार AI इनजेशन के लिए llms.txt और कैटलॉग के ऊपर टूलिंग बनाने के लिए संरचित api/index.json है।

API reference खोलें

अक्सर पूछे जाने वाले सवाल