Te same dane. To samo uwierzytelnianie. Trzy interfejsy do różnych sposobów tworzenia.
Wybór interfejsu dopasowanego do zadania. Większość rzeczywistych integracji łączy dwa: API REST do zapytań, webhooki do reagowania. Serwer MCP warto dodać, gdy do procesu dołącza asystent AI. Bez uzależnienia od SDK, bez zastrzeżonego protokołu, bez osobnych rozliczeń.
Trzy rozwiązania dla deweloperów, jedna flota
Każde z nich rozwiązuje inny rodzaj problemu. Można użyć jednego lub wszystkich trzech. Łączy je ten sam model uprawnień dla użytkowników, te same struktury danych i to samo konto.
JSON przez HTTPS z jednym nagłówkiem X-API-KEY.
Wysyłanie zdarzeń do dowolnego URL, Discord, Slack lub Teams.
Natywny interfejs narzędziowy dla Claude, ChatGPT i innych asystentów AI.
Co deweloperzy tworzą z użyciem SimplyPrint
Rzeczywiste wzorce obserwowane w farmach drukarek, szkołach, makerspace'ach, wśród partnerów OEM i dostawców integracji:
- Niestandardowe przyjmowanie zleceń: portal wycen lub ERP przekazuje opłacone zamówienia prosto do kolejki SimplyPrint przez /queue/AddItem, a po zakończeniu wydruku wysyłany jest webhook. Tak integrują się ShipStation, Shopify i niestandardowe portale zamówień.
- Panele produkcyjne - tablica stanu na ekran TV lub panel BI, który cyklicznie odpytuje API o stan drukarek na żywo, głębokość kolejki i dzienną przepustowość. Webhooki umożliwiają natychmiastowe aktualizacje bez pętli odpytywania.
- Integracje z Discord, Slack i Teams: wystarczy wkleić adres URL webhooka kanału, wybrać zdarzenia ważne dla zespołu i otrzymywać natywne wiadomości. Powiadomienia warsztatu bez kodowania.
- Asystenci AI: można połączyć Claude, ChatGPT lub Gemini przez MCP, aby asystent zatwierdzał pozycje kolejki, znajdował szpule z niskim stanem lub podsumowywał prostym językiem historię wydruków z poprzedniego dnia.
- Integracje sprzętowe - nowy sprzęt AutoPrint (wymieniacze płyt, systemy zrzutu, modyfikacje taśmowe) można podłączyć przez framework integracji AutoPrint za pomocą kilku fragmentów G-code i klasy Integration.
- Wdrożenia white-label: partnerzy OEM używają tego samego API do tworzenia interfejsu dla klientów pod własną marką, opartego na SimplyPrint.
OAuth2 dla aplikacji i platform innych firm
Przy tworzeniu produktu, który inni klienci SimplyPrint połączą ze swoim kontem, należy użyć OAuth2 zamiast prosić każdego klienta o wklejenie klucza API. Po kliknięciu Connect SimplyPrint następuje logowanie na simplyprint.io, wyświetla się dokładna lista żądanych zakresów i można zatwierdzić dostęp. Otrzymywany jest token bearer powiązany z wybranym kontem: bez współdzielonych sekretów, poświadczeń kopiuj-wklej i zgłoszeń do pomocy technicznej dotyczących zgubionych kluczy API.
To ten sam przepływ OAuth2 udostępniany dla integracji partnerskich na platformach takich jak Zapier, n8n, Make i Activepieces, zob. automatyzację przepływów pracy. Kanoniczne adresy URL to:
- Autoryzacja: simplyprint.io/panel/oauth2/authorize
- Wymiana tokenu: simplyprint.io/api/0/oauth2/Token
- Wykrywanie: po wymianie należy wywołać /account/GetUser, aby znaleźć powiązane konto, a następnie użyć /api/{companyId}/{endpoint}
Niestandardowe integracje sprzętowe AutoPrint
Powstaje sprzęt automatyzujący zdejmowanie wydruków: wymieniacz płyt, mechanizm zrzucający, modyfikacja z taśmą, chwytacz części? Framework AutoPrint SimplyPrint stanowi punkt integracji. Każda integracja sprzętowa rejestruje własny szablon Gcode, element enum dla metody oraz klasę Integration udostępniającą metadane marketingowe i MethodDefinition, którego SimplyPrint używa do wykrywania i obsługi sprzętu.
Wśród obecnych partnerów są Chitu PlateCycler, JobOx, FarmLoop oraz samo urządzenie SimplyPrint AutoPrint, wszystkie połączone przez ten sam framework integracyjny. Producent sprzętu, lub SimplyPrint w jego imieniu, dostarcza pojedynczą klasę PHP i fragment Gcode. Resztą, czyli wykrywaniem metod, interfejsem panelu, przekazywaniem kolejki, Gcode po zakończeniu i wykrywaniem zrzucenia wydruku, zajmuje się framework. W przypadku tworzenia sprzętu, który powinien działać jako pełnoprawna metoda AutoPrint, kontakt przez [email protected].
Dostęp w planach: kto może korzystać z każdego interfejsu deweloperskiego
Wszystkie trzy interfejsy dla deweloperów są częścią standardowych planów SimplyPrint, bez osobnego dostępu dla dewelopera, rozliczeń za wywołania ani opłat za zdarzenia. Plany Free, Basic, Cloud Slicer i Filament Manager nie udostępniają żadnego interfejsu dla deweloperów, wszystko poniżej jest dostępne od planu Pro wzwyż.
| Funzionalità / Limite | Gratis | Base | Pro | Print farm | Enterprise | Scuola | Cloud Slicer | Gestore del filamento |
|---|---|---|---|---|---|---|---|---|
|
Dostęp do podstawowego API
Plan Pro i wyższe. JSON przez HTTPS, jeden nagłówek X-API-KEY. Odczyt i ograniczony zapis: stan drukarek, elementy kolejki, zadania, zapasy filamentu, tagi i grupy. 60 żądań na minutę w Pro, 180 w Print Farm i School, 600 w Enterprise.
|
||||||||
|
Rozszerzone API (pełny odczyt i zapis)
Plan Print Farm i wyższe. Umożliwia przesyłanie plików przez /queue/AddItem, zmiany kolejki uruchamiające wydruki, bezpośrednie wysyłanie G-code i zbiorcze operacje zapisu. Dziedziczy większą pulę limitu żądań planu.
|
||||||||
|
Webhooks
Plan Print Farm i wyższe. Pełny wielokanałowy system webhooków: standardowy JSON, Discord, Slack i Microsoft Teams, ponad 60 zdarzeń, opcjonalne podpisywanie HMAC oraz historia poszczególnych wysłań. Bez opłat za webhooki ani każde wysłanie, bez limitów zdarzeń.
|
||||||||
|
Serwer MCP dla asystentów AI
Plan Pro lub wyższy. Można połączyć Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT, Gemini, Cursor i każdego innego asystenta obsługującego MCP, aby zarządzać flotą w języku naturalnym. Oparte na OAuth, z ograniczeniem zakresów, bez opłat za wywołanie. Własna subskrypcja asystenta jest opłacana jego dostawcy.
|
||||||||
|
Zapier, n8n, Make i Activepieces
Plany Pro i wyższe umożliwiają łączenie się przez oficjalne komponenty oparte na OAuth2. Plany Print Farm i wyższe zapewniają za ich pośrednictwem pełny dostęp do zapisu, ponieważ integracje korzystają z poziomu API konta.
|
Vuoi saperne di più sui nostri piani?
Visualizza il confronto completo tra prezzi e funzionalitàPierwsze kroki
Wybór interfejsu do zadania i start:
- REST API: zalogować się do panelu, otworzyć ustawienia konta -> API, nadać kluczowi nazwę i skopiować go. Następnie pełna dokumentacja jest dostępna pod adresem apidocs.simplyprint.io - w tym plik llms.txt i uporządkowany katalog api/index.json, do budowania narzędzi na podstawie samej dokumentacji.
- Webhooks: w panelu należy otworzyć stronę Webhooks, wkleić docelowy URL, dowolny URL albo Webhook kanału Discord / Slack / Teams, i wybrać istotne zdarzenia. Testowe wysyłki są dostępne jednym kliknięciem. Przewodnik: wszystko o funkcji Webhooks.
- MCP: wkleić https://simplyprint.io/api/mcp w ustawieniach niestandardowego złącza / serwera MCP asystenta AI, przejść przez ekran zgody OAuth i zadać asystentowi pytanie. Krok po kroku: połączyć SimplyPrint z dowolnym asystentem AI przez MCP.
- Aplikacje partnerów OAuth2: o klienta można wnioskować przez formularz wniosku o klienta OAuth2, a następnie skonfigurować aplikację pod powyższe adresy URL.
Najczęściej zadawane pytania
Który plan jest potrzebny do korzystania z API?
Czy API ma wersjonowanie?
Jakie obowiązują limity żądań?
Jak uzyskać klucz API?
Co wybrać: klucz API czy OAuth2?
API, webhooki, MCP: czym się różnią?
Czy są oficjalne SDK?
Czy dostępne jest środowisko sandbox lub testowe?
Czy dane służą do trenowania jakiejkolwiek AI?
Gdzie uzyskać pomoc w razie problemów?
Przewodniki konfiguracji krok po kroku
Kompletne przewodniki dla każdego klienta, obejmujące cały zakres funkcji, są dostępne w sekcji dla programistów w centrum pomocy: konfiguracja klucza API, konfiguracja webhooków dla Discord / Slack / Teams oraz przewodniki konfiguracji MCP dla Claude, ChatGPT i Gemini CLI.