API 3D-принтерів SimplyPrint

Запустіть друк одним викликом API

Найшвидший шлях від вашого коду до рухомого екструдера: надішліть ідентифікатор файлу методом POST до /queue/AddItem, укажіть один або кілька принтерів, і SimplyPrint зробить решту. У фоновому режимі черга застосовує ту саму логіку відповідності, схвалення та маршрутизації, що й панель, тож друк почнеться на тому самому принтері, на якому почався б, якби людина натиснула «Друк».

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
}

Значення {companyId} в URL є ідентифікатором вашого облікового запису, а не версією. Його можна знайти в URL панелі після входу. Укажіть for_printers, щоб націлитися на конкретні принтери, або не вказуйте його, щоб SimplyPrint вибрав сумісний принтер. Укажіть position: "top", щоб перемістити завдання на початок черги.

Переглянути всі ендпоїнти

Зчитувати стан. Надсилати команди. Той самий заголовок автентифікації.

Отримайте список усіх принтерів одним викликом. Відповідь містить той самий об'єкт принтера, який відображає панель: стан, поточне завдання, температури, завантажений філамент і решту даних.

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

Призупиніть активний друк, надішліть одноразовий рядок G-code, перемістіть вісь. Усі кінцеві точки працюють у реальному часі та мають однакову структуру 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 для партнерських інтеграцій

Створюєте сторонній застосунок, яким користуватимуться інші клієнти SimplyPrint? Використовуйте OAuth2, щоб кожен клієнт міг підключити власний обліковий запис через екран згоди, без спільних ключів API і секретів, які треба копіювати й вставляти. Це той самий процес, який використовує наша офіційна інтеграція Cura і який ми надаємо для партнерських інтеграцій на платформах на кшталт Zapier, n8n, Make та 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"

Схвалені клієнти OAuth2 створюються через форму запиту на клієнта OAuth2. Надішліть нам свої URI перенаправлення, запитані області доступу та один абзац з описом того, що робить ваш застосунок.

Запросити доступ для клієнта OAuth2

Повна довідка доступна на apidocs.simplyprint.io

Кожна кінцева точка, структура запитів і відповідей, коди помилок, потік OAuth2, список областей доступу. Документація також зручна для ШІ: є llms.txt для одноразового завантаження документації в ШІ та структурований api/index.json, якщо ви хочете створити інструменти на основі каталогу.

Відкрити довідник API

Часті запитання