Платформа для разработчиков, работающих с парками 3D-принтеров

Разрабатывайте с SimplyPrint

Три компонента, одна модель авторизации, один парк. REST API для кода, который запрашивает состояние по требованию. Webhooks для событий, которые SimplyPrint отправляет сразу после изменения. MCP server для ИИ-помощников, которые управляют вашим парком на естественном языке. Каждая конечная точка, событие и инструмент доступны через тот же интерфейс, который внутренне использует панель SimplyPrint, поэтому принтер в вашем коде является тем же принтером, который ваша команда видит в приложении.

Начать бесплатно Подробнее и инструкция

Те же данные. Та же аутентификация. Три интерфейса под ваш подход к разработке.

Выберите интерфейс, соответствующий вашей задаче. Большинство реальных интеграций используют два из них: REST API для запросов и вебхуки для реакции на события. Добавьте MCP сервер, когда к процессу подключается ИИ-помощник. Без привязки к SDK, проприетарных протоколов и отдельной оплаты.

Три интерфейса для разработчиков, один парк

Каждый решает свой тип задач. Используйте один или все три. У них общая модель разрешений на пользователя, одинаковые структуры данных и один аккаунт.

JSON через HTTPS с одним заголовком X-API-KEY.

Отправляйте события на любой URL, Discord, Slack или Teams.

Нативный интерфейс инструментов для Claude, ChatGPT и других AI-ассистентов.

Что разработчики на самом деле создают с SimplyPrint

Реальные закономерности, которые мы видим на фермах печати, в школах, мейкерспейсах, у партнёров OEM и поставщиков интеграций:

  • Приём пользовательских заказов: портал расчёта стоимости или ERP отправляет оплаченные заказы прямо в очередь SimplyPrint через /queue/AddItem, а после завершения печати вебхук возвращает уведомление. ShipStation, Shopify и индивидуальные порталы заказов подключаются так же.
  • Производственные дашборды: статусная панель для ТВ или BI-дашборд, опрашивающий API для получения состояния принтеров в реальном времени, размера очереди и ежедневной производительности. Сочетайте с вебхуками для мгновенных обновлений вместо циклов опроса.
  • Интеграции с Discord, Slack и Teams: вставьте URL вебхука канала, выберите важные для команды события и получайте нативные сообщения. Уведомления мастерской без кода.
  • AI-помощники: подключайте Claude, ChatGPT или Gemini через MCP, чтобы помощник мог одобрять элементы очереди, находить катушки с низким остатком или кратко пересказывать вчерашнюю историю печати простым языком.
  • Аппаратные интеграции: новое оборудование AutoPrint, сменщики пластин, системы сброса и модификации с лентой, подключается через платформу интеграций AutoPrint с несколькими фрагментами gcode и классом Integration.
  • Развёртывания под брендом партнёра: OEM-партнёры используют тот же API для брендированного интерфейса для клиентов на базе SimplyPrint.

OAuth2 для сторонних приложений и платформ

Создаёте продукт, который другие клиенты SimplyPrint будут подключать к своему аккаунту? Используйте OAuth2 вместо того, чтобы просить каждого клиента вставлять API-ключ. Они нажимают Подключить SimplyPrint, входят на simplyprint.io, видят точный список запрашиваемых областей доступа и подтверждают его. В ответ выдаётся bearer-токен, привязанный к выбранному аккаунту: без общих секретов, ручного копирования учётных данных и обращений в поддержку из-за потерянных API-ключей.

Это тот же поток OAuth2, который предоставляется для интеграций партнёров на платформах Zapier, n8n, Make и Activepieces (см. автоматизацию рабочих процессов). Канонические URL:

Примечание: интеграционный OAuth2, URL выше, отделён от потока OAuth MCP по адресу /oauth/authorize. Поток MCP предназначен только для ИИ-клиентов. Если вы создаёте пользовательский коннектор для Claude / ChatGPT, используйте его и см. страницу функции MCP. Одобренные OAuth2-клиенты предоставляются SimplyPrint через форму запроса OAuth2-клиента.

Запросить OAuth2-клиент

Индивидуальные аппаратные интеграции AutoPrint

Разрабатываете оборудование, которое автоматизирует снятие отпечатков: устройство смены пластин, механизм сталкивания, модификацию с лентой или ловитель деталей? Платформа AutoPrint от SimplyPrint служит точкой интеграции. Каждая аппаратная интеграция регистрирует собственный шаблон Gcode, значение перечисления для метода и класс Integration, предоставляющий маркетинговые метаданные и MethodDefinition, который SimplyPrint использует для обнаружения и управления оборудованием.

Среди существующих партнёров: Chitu PlateCycler, JobOx, FarmLoop и само устройство SimplyPrint AutoPrint. Все они подключаются через единую платформу интеграции. Поставщик оборудования, либо SimplyPrint от его имени, поставляет один класс PHP и фрагмент Gcode. Всё остальное, обнаружение методов, интерфейс панели, передача в очередь, Gcode по завершении, обнаружение сброса изделия, обрабатывает платформа. Свяжитесь с нами по адресу [email protected], если вы разрабатываете оборудование, которое должно поставляться как полноценный метод AutoPrint.

Посмотреть страницу функции AutoPrint

Доступность в планах: кому доступен каждый интерфейс для разработчиков

Все три интерфейса для разработчиков входят в стандартные планы SimplyPrint: без отдельного места для разработчика, оплаты за вызов или комиссии за событие. Планы Free, Basic, Cloud Slicer и Filament Manager не предоставляют доступ ни к одному интерфейсу для разработчиков, всё перечисленное ниже доступно только в Pro и выше.

Функция / ограничение Free Базовый Pro Ферма печати Enterprise Школа Облачный слайсер Менеджер филамента
Доступ к Basic API
На тарифе Pro и выше. JSON через HTTPS, один заголовок X-API-KEY. Доступ на чтение и ограниченная запись: состояние принтеров, элементы очереди, задания, инвентарь филамента, теги и группы. 60 запросов в минуту на Pro, 180 на Print Farm и School, 600 на Enterprise.
Расширенный API (полное чтение и запись)
Тариф Print Farm и выше. Открывает загрузку файлов через /queue/AddItem, изменения очереди с запуском печати, прямую отправку G-code и массовую запись данных. Используется общий пул повышенного лимита запросов тарифа.
Вебхуки
Тариф Print Farm и выше. Полная многоканальная система вебхуков: обычный JSON, Discord, Slack и Microsoft Teams, более 60 событий, необязательная HMAC-подпись и история каждой доставки. Без платы за вебхук или доставку, без лимитов на события.
MCP-сервер для ИИ-ассистентов
На тарифе Pro и выше. Подключите Claude (claude.ai, Claude Desktop, Claude Code), ChatGPT, Gemini, Cursor и любого другого ассистента с поддержкой MCP для управления парком на естественном языке. На основе OAuth, с ограничением областей доступа, без платы за вызовы. Подписка на ассистента оплачивается его поставщику.
Zapier, n8n, Make и Activepieces
На тарифе Pro и выше доступно подключение через официальные компоненты на основе OAuth2. На тарифе Print Farm и выше через них доступен полный доступ на запись, поскольку интеграции используют уровень API аккаунта.

Хотите узнать больше о наших тарифах?

Посмотреть все цены и сравнение функций

Начало работы

Выберите интерфейс, подходящий для вашей задачи:

  • REST API: войдите в панель, откройте настройки аккаунта → API, назовите ключ и скопируйте его. Затем ознакомьтесь с полной справкой на apidocs.simplyprint.io, включая файл llms.txt и структурированный каталог api/index.json, если хотите создать инструменты поверх самой документации.
  • Webhooks: откройте страницу Webhooks в панели, вставьте URL назначения, любой URL или Webhook канала Discord / Slack / Teams, и выберите нужные события. Тестовая отправка выполняется в один клик. Подробнее: всё о функции Webhooks.
  • MCP: вставьте https://simplyprint.io/api/mcp в настройки пользовательского коннектора / MCP-сервера ИИ-помощника, пройдите экран согласия OAuth и задайте помощнику вопрос. Пошагово: подключение SimplyPrint к любому ИИ-помощнику через MCP.
  • Партнёрские приложения OAuth2: запросите клиент через форму запроса OAuth2-клиента, затем настройте приложение на указанные выше URL.
Застряли? Присоединяйтесь к Discord SimplyPrint, в канале #developers обсуждаются API и интеграции, или напишите на [email protected], если нужна более подробная консультация.

Открыть справочник API

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

Доступ к Basic API начинается с Pro. Расширенный API, включая загрузку файлов, изменения очереди, запускающие печать, и прямую отправку G-code, доступен с Print Farm. Webhooks доступны на Print Farm и выше. MCP для ИИ-ассистентов доступен на Pro и выше. Тарифы Free, Basic, Cloud Slicer и Filament Manager не предоставляют инструментов для разработчиков.
URL имеет вид https://api.simplyprint.io/{id}/{endpoint}: число после хоста является ID вашего аккаунта, а не версией. Сам API не использует версионирование в URL: мы расширяем его, не нарушая существующий интерфейс. Эндпоинты, форматы запросов и ответов стабильны: могут добавляться новые поля, но существующие не удаляются и не меняют назначение.
60 запросов в минуту на Pro, 180 в минуту на Print Farm и School, 600 в минуту на Enterprise. Превышение лимита вызывает 60-секундный тайм-аут, после чего ограничитель сбрасывается. Несколько дополнительных запросов в одну секунду допустимы, интервал скользящий и длится полную минуту.
Войдите в панель, откройте Настройки аккаунта → API, задайте имя ключу и скопируйте его. Это займёт 30 секунд. Каждый ключ привязан к вашему пользователю и наследует назначенные ему права доступа в аккаунте, поэтому интеграция получает ровно тот доступ, который разрешён этому пользователю, и не больше.
Ключ API для собственных интеграций со своим аккаунтом: самый простой путь, один заголовок. OAuth2, если вы создаёте продукт, который другие клиенты SimplyPrint подключат к своему аккаунту: тогда каждый клиент выдаёт разрешение на экране согласия, а его данные для входа вам недоступны. Одобренные клиенты OAuth2 выдаются через форму запроса клиента OAuth2.
API работает по модели pull: ваш код запрашивает у SimplyPrint данные состояния по требованию. Webhooks работают по модели push: SimplyPrint сообщает вашему коду о любом изменении сразу, без опроса, манипуляций с ограничениями частоты и пропущенных событий. MCP server является нативным набором инструментов для ИИ-помощников: те же данные, та же авторизация и проверенный реестр инструментов вместо необработанных эндпоинтов. Большинство интеграций используют один из них. Продвинутые интеграции сочетают все три.
Пока нет, API представляет собой обычный JSON поверх HTTPS, поэтому любой современный HTTP-клиент позволяет начать работу несколькими строками кода. Мы предлагаем официальную интеграцию с Cura, сервер SimplyPrint MCP для ИИ-агентов, а также по запросу предоставляем OAuth2-клиенты для партнёрских интеграций на таких платформах, как Zapier, n8n, Make и Activepieces. Если нужен SDK для конкретного языка, свяжитесь с нами через [email protected].
Публичной песочницы нет, интеграции создаются для вашего реального аккаунта. Для разработки можно создать отдельный тестовый аккаунт, Free или Pro, с собственным API-ключом и направить интеграцию на него до перехода на ключи рабочей среды. По запросу можно предоставить удобную для разработки настройку серьёзным партнёрам по интеграции.
Обучение ИИ SimplyPrint на ваших данных не проводится. Данные, отправленные через MCP, передаются поставщику ассистента, Anthropic, OpenAI или Google, в соответствии с его собственными правилами обработки данных и обучения. Если нужно отказаться от обучения там, проверьте настройки конфиденциальности вашего ассистента.
В SimplyPrint Discord есть канал #developers, где отвечают на большинство вопросов об API и интеграциях. По вопросам, требующим более долгого обсуждения, например настройке клиента OAuth2, партнёрстве по индивидуальным интеграциям, OEM/white-label или интеграции оборудования, пишите на [email protected].

Пошаговые руководства по настройке

Полные пошаговые руководства для каждого клиента по всем функциям доступны в разделе для разработчиков службы поддержки: настройка ключа API, вебхуков для Discord / Slack / Teams и MCP для Claude, ChatGPT и Gemini CLI.

Оглавление