3D yazıcı filoları için geliştirici platformu

SimplyPrint ile geliştirin

Üç temel yapı, tek kimlik doğrulama modeli, tek filo. İstek üzerine durum alan kodlar için REST API. Bir şey değiştiği anda SimplyPrint'in gönderdiği olaylar için Webhooks. Filonuzu doğal dille yöneten AI asistanları için MCP sunucusu. Her uç nokta, olay ve araç, SimplyPrint panelinin dahili olarak kullandığı arayüzle aynıdır; yani kodunuzdaki bir yazıcı, ekibinizin uygulamada gördüğü yazıcıyla aynıdır.

Ücretsiz başla Daha fazla bilgi ve kılavuz

Aynı veri. Aynı kimlik doğrulama. Geliştirme şeklinize uygun üç arayüz.

İşinize uygun yüzeyi seçin. Gerçek entegrasyonların çoğu ikisini birlikte kullanır: sorgulamak için REST API, tepki vermek için webhooks. Döngüye bir AI asistanı katıldığında MCP sunucusunu ekleyin. SDK bağımlılığı, özel protokol veya ayrı faturalandırma yoktur.

Üç geliştirici arayüzü, tek filo

Her biri farklı biçimdeki bir sorunu çözer. Birini kullanın. Üçünü de kullanın. Aynı kullanıcı bazlı izin modelini, aynı veri biçimlerini ve aynı hesabı paylaşırlar.

Tek X-API-KEY üst bilgisiyle HTTPS üzerinden JSON.

Olayları herhangi bir URL'ye, Discord'a, Slack'e veya Teams'e gönderin.

Claude, ChatGPT ve diğer AI asistanları için yerel araç arayüzü.

Geliştiricilerin SimplyPrint ile gerçekten geliştirdikleri

Baskı çiftlikleri, okullar, maker alanları, OEM ortakları ve entegrasyon sağlayıcılarında gördüğümüz gerçek kalıplar:

  • Özel iş alımı: Ücretli siparişleri /queue/AddItem üzerinden doğrudan SimplyPrint kuyruğuna aktaran bir fiyat teklifi portalı veya ERP ve baskı tamamlandığında geri bildirim gönderen bir webhook. ShipStation, Shopify ve özel sipariş portalları bu şekilde bağlanır.
  • Üretim Gösterge panelleri: Canlı yazıcı durumu, kuyruk derinliği ve günlük verim için API'yi sorgulayan TV boyutunda durum panosu veya BI Gösterge paneli. Sorgu döngüleri yerine anında güncelleme için web kancalarıyla eşleştirin.
  • Discord, Slack ve Teams bağlantıları: Bir kanal webhook URL'si yapıştırın, ekip için önemli olayları seçin ve platforma özgü mesajlar alın. Kod gerektirmeyen atölye bildirimleri.
  • AI yardımcıları: Claude, ChatGPT veya Gemini'yi MCP üzerinden bağlayın. Yardımcı, kuyruk öğelerini onaylasın, stoğu azalan makaraları bulsun veya dünkü baskı geçmişini sade İngilizceyle özetlesin.
  • Donanım entegrasyonları - yeni AutoPrint donanımları (plaka değiştiriciler, iterek çıkarma sistemleri, bant modları), birkaç G-code parçacığı ve bir Integration sınıfıyla AutoPrint entegrasyon çerçevesi üzerinden bağlanır.
  • Beyaz etiketli dağıtımlar, OEM iş ortakları SimplyPrint üzerinde markalı müşteri deneyimi sunmak için aynı API arayüzünü kullanır.

Üçüncü taraf uygulamalar ve platformlar için OAuth2

Diğer SimplyPrint müşterilerinin hesaplarına bağlayacağı bir ürün mü geliştiriyorsunuz? Her müşteriden bir API anahtarı yapıştırmasını istemek yerine OAuth2 kullanın. Müşterileriniz Connect SimplyPrint'e tıklar, simplyprint.io'da oturum açar, istediğiniz kapsamların tam listesini görür ve onay verir. Seçtikleri hesaba bağlı bir bearer token alırsınız; paylaşılan gizli bilgiler, kopyala-yapıştır kimlik bilgileri veya kaybolan API anahtarlarıyla ilgili destek talepleri olmaz.

Bu, Zapier, n8n, Make ve Activepieces gibi platformlardaki iş ortağı entegrasyonları için sağladığımız aynı OAuth2 akışıdır (iş akışı otomasyonuna bakın). Standart URL'ler şunlardır:

Not: entegrasyon OAuth2'si (yukarıdaki URL'ler), /oauth/authorize adresindeki MCP OAuth akışından ayrıdır. MCP akışı yalnızca AI istemcileri içindir; Claude / ChatGPT için özel bağlantı geliştiriyorsanız onu kullanın ve MCP özellik sayfasına bakın. Onaylanan OAuth2 istemcileri SimplyPrint tarafından OAuth2 İstemci Talep Formu aracılığıyla sağlanır.

OAuth2 istemcisi talep et

Özel AutoPrint donanım entegrasyonları

Baskı tablasını boşaltmayı otomatikleştiren donanım mı geliştiriyorsunuz: plaka değiştirici, iterek çıkarma mekanizması, bant modu veya parça yakalayıcı? SimplyPrint'in AutoPrint çerçevesi entegrasyon noktasıdır. Her donanım entegrasyonu kendi Gcode şablonunu, yöntem için bir enum durumunu ve pazarlama meta verileriyle SimplyPrint'in donanımı keşfedip çalıştırmak için kullandığı MethodDefinition öğesini sunan bir Integration sınıfını kaydeder.

Mevcut iş ortakları arasında Chitu PlateCycler, JobOx, FarmLoop ve SimplyPrint AutoPrint cihazının kendisi bulunur; hepsi aynı entegrasyon çerçevesine bağlıdır. Donanım tedarikçisi (veya tedarikçi adına SimplyPrint) tek bir PHP sınıfı ve Gcode parçacığı sunar. Geri kalanı, yani yöntem keşfi, panel kullanıcı arayüzü, baskı kuyruğu devri, iş sonu gcode ve iterek çıkarma algılama, çerçeve tarafından yönetilir. Birinci sınıf AutoPrint yöntemi olarak sunulması gereken donanım geliştiriyorsanız [email protected] üzerinden bizimle görüşün.

AutoPrint özellik sayfasını incele

Plan erişimi: her geliştirici yüzeyini kim kullanabilir?

Üç geliştirici arayüzünün tamamı standart SimplyPrint planlarına dahildir: ayrı geliştirici lisansı, çağrı başı ücretlendirme veya etkinlik başı ücret yoktur. Free, Basic, Cloud Slicer ve Filament Manager planları herhangi bir geliştirici arayüzü sunmaz; aşağıdaki her şey yalnızca Pro ve üzeri planlarda kullanılabilir.

Özellik / sınır Ücretsiz Basic Pro Baskı çiftliği Kurumsal Okul Bulut slicer Filament yöneticisi
Temel API erişimi
Pro ve üzeri. HTTPS üzerinden JSON, tek X-API-KEY başlığı. Okuma erişiminin yanı sıra yazıcı durumu, kuyruk öğeleri, işler, filament envanteri, etiketler ve gruplarda hafif yazma işlemleri. Pro'da dakikada 60, Print Farm ve School'da 180, Enterprise'ta 600 istek.
Gelişmiş API (tam okuma ve yazma)
Print Farm ve üzeri. /queue/AddItem üzerinden dosya yüklemeyi, baskı başlatan kuyruk değişikliklerini, doğrudan G-code göndermeyi ve toplu yazma işlemlerini açar. Planın daha yüksek hız sınırı havuzunu devralır.
Webhooks
Print Farm ve üzeri. Standart JSON, Discord, Slack ve Microsoft Teams için 60+ olay, isteğe bağlı HMAC imzalama ve teslimat geçmişi sunan eksiksiz çok kanallı webhook sistemi. Webhook başına ücret, teslimat başına ücret veya olay sınırı yoktur.
Yapay zeka asistanları için MCP sunucusu
Pro ve üzeri. Filonuzu doğal dille yönetmek için Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT, Gemini, Cursor ve MCP destekli diğer tüm asistanları bağlayın. OAuth tabanlı, kapsamla sınırlandırılmış ve çağrı başına ücretsizdir. Asistanın kendi aboneliği sağlayıcısına ödenir.
Zapier, n8n, Make ve Activepieces
Pro ve üzeri, resmî OAuth2 tabanlı bileşenlerle bağlanabilir. Entegrasyonlar hesabın API kademesini kullandığı için Print Farm ve üzeri bunlar üzerinden tam yazma erişimi elde eder.

Planlarımız hakkında daha fazla bilgi ister misiniz?

Tam fiyat ve özellik karşılaştırmasını görüntüle

Başlangıç

İşinize uygun yüzeyi seçip başlayın:

  • REST API: Panelde oturum açın, hesap ayarları -> API bölümünü açın, anahtara ad verin ve kopyalayın. Ardından belgelerin üzerinde araç geliştirmek istiyorsanız llms.txt dosyası ve yapılandırılmış api/index.json kataloğu dahil tam başvuruyu apidocs.simplyprint.io adresinden okuyun.
  • Webhooks: paneldeki webhooks sayfasını açın, bir hedef URL'yi yapıştırın (herhangi bir URL veya Discord / Slack / Teams kanal webhook'u) ve önemli olayları seçin. Test teslimatları tek tık uzağınızdadır. Rehber: webhooks özelliği hakkında her şey.
  • MCP: https://simplyprint.io/api/mcp adresini AI yardımcınızın özel bağlayıcı veya MCP sunucusu ayarlarına yapıştırın, OAuth onay ekranını tamamlayın ve yardımcıya bir soru sorun. Adım adım: SimplyPrint'i MCP üzerinden herhangi bir AI yardımcısına bağlama.
  • OAuth2 iş ortağı uygulamaları: OAuth2 İstemci Talep Formu üzerinden istemci talep edin, ardından uygulamanızı yukarıdaki URL'lere yönlendirin.
Takıldınız mı? API ve entegrasyon çalışmalarının konuşulduğu #developers kanalı için SimplyPrint Discord sunucusuna katılın. Daha ayrıntılı görüşme gerektiren konular için [email protected] adresine e-posta gönderin.

API referansını aç

Sık sorulan sorular

Temel API erişimi Pro planından itibaren sunulur. Gelişmiş API (dosya yükleme, baskı başlatan kuyruk değişiklikleri, doğrudan G-code gönderimi) Print Farm planından itibaren sunulur. Webhooks Print Farm ve üstü planlarda bulunur. AI asistanları için MCP, Pro ve üstü planlarda bulunur. Free, Basic, Cloud Slicer ve Filament Manager planları geliştirici özellikleri sunmaz.
URL https://api.simplyprint.io/{id}/{endpoint} biçimindedir. Ana bilgisayardan sonraki sayı, sürüm değil hesap kimliğinizdir. API'nin kendisi URL'de sürümlendirilmez; yeni özellikler ekleriz ancak mevcut API arayüzünü bozmayız. Uç noktalar, istek ve yanıt yapıları kararlıdır. Yeni alanlar eklenebilir, mevcut alanlar kaldırılmaz veya başka amaçla kullanılmaz.
Pro'da dakikada 60, Print Farm ve School'da 180, Enterprise'ta 600 istek. Sınıra ulaşılması 60 saniyelik zaman aşımı döndürür; sınırlayıcı bunun ardından sıfırlanır. Tek bir saniyede birkaç ek çağrının ani olarak gönderilmesi sorun değildir, pencere tam bir dakika boyunca ilerler.
Panele giriş yapın, hesap ayarları -> API bölümünü açın, anahtarınıza ad verip kopyalayın. 30 saniyede tamamlanır. Her anahtar kullanıcınıza bağlıdır ve hesaptaki izinlerinizi devralır. Böylece entegrasyon yalnızca sahibinin sahip olduğu erişimle çalışır, daha fazlasıyla değil.
Kendi hesabınızdaki entegrasyonlar için API anahtarı, en basit yol ve tek bir üst bilgi. Diğer SimplyPrint müşterilerinin kendi hesaplarına bağlayacağı bir ürün geliştiriyorsanız OAuth2 kullanın. Böylece her müşteri onay ekranından yetki verir ve kimlik bilgilerini hiçbir zaman görmezsiniz. Onaylı OAuth2 istemcileri OAuth2 İstemci İstek Formu üzerinden sağlanır.
API çekmedir: kodunuz gerektiğinde SimplyPrint'ten durum ister. Webhooks itmedir: SimplyPrint bir şey değiştiği anda kodunuza bildirir. Yoklama, hız sınırı yönetimi veya kaçırılan olay yoktur. MCP sunucusu, AI asistanları için yerel araç yüzeyidir: aynı veriler, aynı kimlik doğrulama, ham uç noktalar yerine incelenmiş araç kaydı. Çoğu entegrasyon birini kullanır. Gelişmiş olanlar üçünü birleştirir.
Henüz değil, API HTTPS üzerinden düz JSON'dır; dolayısıyla her modern HTTP istemcisi birkaç satırda kullanışlı bir arayüz sunar. Cura için resmî entegrasyon, AI ajanları için SimplyPrint MCP sunucusu sunuyoruz; Zapier, n8n, Make ve Activepieces gibi platformlardaki iş ortağı entegrasyonları için de talep üzerine OAuth2 istemcileri sağlıyoruz. Dile özgü SDK'ye ihtiyacınız varsa [email protected] üzerinden bizimle iletişime geçin.
Herkese açık sandbox yoktur; entegrasyonlar gerçek hesabınız üzerinde geliştirilir. Geliştirme için ayrı (ücretsiz veya Pro) test hesabı oluşturabilir, kendi API anahtarını üretebilir ve üretim anahtarlarına geçmeden önce entegrasyonunuzu ona yönlendirebilirsiniz. Ciddi entegrasyon iş ortakları için talep üzerine geliştirici dostu kurulum sağlamaktan memnuniyet duyarız.
Verilerinizle SimplyPrint yapay zekâ eğitimi yapılmaz. MCP üzerinden gönderilen veriler asistanın üreticisine (Anthropic, OpenAI, Google) kendi veri ve eğitim politikalarına göre gider; oradaki eğitimden çıkmak istiyorsanız asistanınızın gizlilik ayarlarını kontrol edin.
SimplyPrint Discord sunucusunda çoğu API ve entegrasyon sorusunun yanıtlandığı #developers kanalı bulunur. OAuth2 istemci sağlama, özel entegrasyon iş ortaklıkları, OEM/beyaz etiket veya donanım entegrasyonu gibi daha uzun görüşme gerektiren konular için [email protected] adresine e-posta gönderin.

Adım adım kurulum kılavuzları

Her yüzey için istemci bazında tam kılavuzlar yardım merkezinin geliştiriciler bölümünde bulunur: API anahtarı kurulumu, Discord / Slack / Teams için webhook yapılandırması ve Claude, ChatGPT ile Gemini CLI için MCP kurulum kılavuzları.

İçindekiler