API drukarki 3D SimplyPrint

Rozpocznij wydruk jednym wywołaniem API

Najszybsza droga od kodu do ruchu ekstrudera: wystarczy wysłać metodą POST identyfikator pliku do /queue/AddItem, wskazać jedną lub więcej drukarek, a SimplyPrint zajmie się resztą. W tle kolejka korzysta z tej samej logiki dopasowywania, zatwierdzania i routingu co panel, dzięki czemu drukowanie rozpoczyna się na tej samej drukarce co po ręcznym kliknięciu „Drukuj”.

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

Odpowiedź w przypadku powodzenia:

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

{companyId} w adresie URL to identyfikator konta, a nie wersja. Jest widoczny w adresie URL panelu po zalogowaniu. Ustawienie for_printers pozwala wskazać konkretne drukarki, a pominięcie go pozwala SimplyPrint wybrać zgodną drukarkę. Ustawienie position: "top" przenosi zadanie na początek kolejki.

Zobacz wszystkie endpointy

Odczyt stanu. Wysyłanie poleceń. Ten sam nagłówek uwierzytelniania.

Jedno wywołanie zwraca listę wszystkich drukarek. Odpowiedź zawiera ten sam obiekt drukarki, który wyświetla panel: status, bieżące zadanie, temperatury, załadowany filament, wszystko.

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

Można wstrzymać trwający wydruk, wysłać jednorazową linię G-code i przesunąć oś - wszystkie te aktywne endpointy mają ten sam format danych wejściowych i wyjściowych JSON.

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 dla integracji partnerskich

Przy tworzeniu aplikacji zewnętrznej, z której będą korzystać inni klienci SimplyPrint, należy użyć OAuth2, aby każdy klient mógł połączyć własne konto przez ekran zgody: bez współdzielonych kluczy API i sekretów kopiuj-wklej. To ten sam proces, z którego korzysta nasza oficjalna integracja z Cura, oraz ten sam, który udostępniamy dla integracji partnerskich na platformach takich jak Zapier, n8n, Make i 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"

Zatwierdzone klienty OAuth2 są udostępniane za pośrednictwem formularza zgłoszeniowego klienta OAuth2. Należy przesłać identyfikatory URI przekierowania, żądane zakresy oraz opis działania aplikacji w jednym akapicie.

Poproś o dostęp do klienta OAuth2

Pełna dokumentacja znajduje się na apidocs.simplyprint.io

Każdy endpoint, format żądania i odpowiedzi, kody błędów, przepływ OAuth2, lista zakresów. Dokumentacja jest też przyjazna dla AI, dostępny jest llms.txt do jednorazowego importu przez AI oraz uporządkowany api/index.json, jeśli trzeba zbudować narzędzia na bazie katalogu.

Otwórz dokumentację API

Najczęściej zadawane pytania