SimplyPrint 3D yazıcı API'si

Tek API çağrısıyla baskı başlatın

Kodunuzdan hareket eden ekstrudere en hızlı yol: bir dosya kimliğini /queue/AddItem adresine POST edin, bir veya birden fazla yazıcıyı hedefleyin, gerisini SimplyPrint halleder. Arka planda kuyruk, panelin kullandığı aynı eşleştirme, onay ve yönlendirme mantığını çalıştırır; böylece baskı, bir insanın Yazdır'a basması durumunda başlayacağı yazıcıda başlar.

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

Başarılı yanıt:

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

URL'deki {companyId}, sürüm değil hesap kimliğinizdir. Giriş yaptıktan sonra panel URL'sinde bulun. Belirli yazıcıları hedeflemek için for_printers ayarlayın veya SimplyPrint'in uyumlu olanı seçmesi için atlayın. Kuyruğun başına geçmek için position: "top" ayarlayın.

Tüm uç noktaları inceleyin

Durumu okuyun. Komut gönderin. Aynı yetkilendirme başlığı.

Tüm yazıcıları tek çağrıyla listeleyin. Yanıt, panelin görüntülediği aynı yazıcı nesnesidir: durum, mevcut iş, sıcaklıklar, takılı filament ve diğer her şey.

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

Çalışan baskıyı duraklatın, tek seferlik bir G-code satırı gönderin, bir ekseni hareket ettirin, bunların tümü canlı uç noktalardır ve aynı JSON giriş/çıkış yapısına sahiptir.

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

İş ortağı entegrasyonları için OAuth2

Diğer SimplyPrint müşterilerinin kullanacağı üçüncü taraf bir uygulama mı geliştiriyorsunuz? Her müşterinin kendi hesabını onay ekranıyla bağlayabilmesi için OAuth2 kullanın; paylaşılan API anahtarları veya kopyala-yapıştır gizli bilgiler olmaz. Bu, resmi Cura entegrasyonumuzun kullandığı akışla aynıdır; Zapier, n8n, Make ve Activepieces gibi platformlardaki iş ortağı entegrasyonları için de sağladığımız akıştır.

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

Onaylanmış OAuth2 istemcileri, OAuth2 İstemci İstek Formu aracılığıyla sağlanır. Yönlendirme URI'lerinizi, istenen kapsamları ve uygulamanızın ne yaptığını açıklayan tek paragraflık bir açıklamayı bize gönderin.

OAuth2 istemci erişimi talep et

Tüm API referansı apidocs.simplyprint.io adresindedir

Her uç nokta, istek ve yanıt biçimi, hata kodları, OAuth2 akışı, kapsam listesi. Belgeler yapay zekâ dostudur: tek seferlik yapay zekâ alımı için llms.txt, katalog üzerinde araç geliştirmek için yapılandırılmış api/index.json bulunur.

API referansını aç

Sık sorulan sorular