API-токены и вебхуки

Токены и вебхуки нужны, чтобы подключить 3D Print Pricing к Home Assistant, Discord, Slack, n8n или собственным скриптам. Полная документация с песочницей — на странице для разработчиков.

Как это работает

Токен доступа.

1. Откройте «Настройки → Интеграции → Разработчикам → Токены доступа».
2. Создайте токен и выберите срок: 30 дней, 90 дней, 1 год (по умолчанию) или без срока. Можно иметь до 10 действующих токенов.
3. Скопируйте токен сразу. На почту придёт письмо о создании — если это были не вы, удалите токен.
4. Заведите отдельный токен под каждую интеграцию, чтобы отозвать один, не трогая остальные.

Токен даёт доступ к заказам, принтерам, филаментам, расчёту и вебхукам. Он не управляет аккаунтом: нельзя выпускать токены, делать бэкап, менять пароль и почту, удалять аккаунт, приглашать людей, завершать сессии, отправлять документы по почте и давать принтеру команды паузы или остановки.

Вебхуки. В «Интеграции → Разработчикам» добавьте канал: свой адрес, Home Assistant, Discord или Slack. Адрес должен быть публичным https. Для каждого канала галочками выбираются события: новый заказ, смена статуса заказа, печать завершена, ошибка печати, филамент заканчивается, новая заявка из каталога мастеров, счёт оплачен клиентом. У старых каналов остаются два заказных события, новые включаются вручную. Тело запроса подписывается, примеры данных — на странице для разработчиков.

Частые вопросы

Интеграция вдруг перестала работать. Возможно, истёк срок токена — создайте новый.

Приходят ли повторы, если приёмник недоступен? Нет, доставка без повторов.

Если что-то не так

Токен возвращает ошибку 401 — он истёк или удалён. Вебхук не приходит — проверьте, что адрес публичный https и нужные события отмечены.