API SimplyPrint для 3D-принтеров

Запустить печать одним вызовом API

Самый быстрый путь от вашего кода к движущемуся экструдеру: отправьте POST-запрос с ID файла в /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 является ID вашего аккаунта, а не версией. Его можно найти в 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

Часто задаваемые вопросы