Все руководства

Команда и администрирование

Токены API

Программы, скрипты и автоматизации управляют Sealed Print с помощью токена API.

Токен API даёт программе доступ к REST API Sealed Print, например чтобы отслеживать задания, управлять назначениями или читать очередь из скрипта. Токен действует от имени человека, который его создал, с правами не выше его собственных и только в той организации, где он был создан. Справочник API описывает все эндпоинты с примерами.

Предварительные условия

  • Любой участник может создавать токены в сеансе браузера. Администраторы видят все токены организации и могут их отзывать.
  • Токены управляют Sealed Print: заданиями, источниками, назначениями и настройками. Они не могут отправлять задания; вместо этого программы отправляют документы на API-эндпоинт.
  • Входит в каждый тариф.

Однократная настройка

  1. Перейдите в Настройки → Токены API и выберите Новый токен.
  2. Введите Название, которое говорит, для чего используется токен, например «Экспорт счетов в бухгалтерию».
  3. Выберите Права: пользователь (ваши собственные источники, назначения и задания), администратор или владелец, но не выше вашей собственной роли.
  4. Выберите Срок действия: 7, 30 или 90 дней, 1 год, собственная дата или без срока.
  5. Выберите Создать и скопируйте токен. Токен показывается только сейчас; сохраните его в надёжном месте, например в менеджере паролей.

Отправляйте токен с каждым запросом в заголовке Authorization: Bearer sp_api_…. Список ваших заданий:

curl "https://www.sealedprint.com/api/jobs" \
  -H "Authorization: Bearer sp_api_…"

С тем же заголовком программа отслеживает задание (GET /api/jobs/{id}), отправляет его в другие назначения или отменяет его.

Каждый раз

  • Последнее использование в списке токенов показывает, использует ли программа ещё токен.
  • Переименовать меняет название; Перевыпустить выдаёт новый секрет для того же токена (старый сразу перестаёт работать, название, права и срок действия сохраняются); Отозвать окончательно прекращает его действие.
  • Показать истёкшие и отозванные выводит токены, которые больше не работают.

Устранение неполадок

  • HTTP 401: токен отсутствует, неверен, истёк или отозван.
  • HTTP 403: права токена не разрешают это действие. Отправить задание с помощью токена нельзя (код api_endpoint_required); отправьте документ на API-эндпоинт.
  • Токен внезапно перестал работать: токены становятся недействительными, когда создавший их человек покидает организацию. Создайте новый токен от имени другого участника.
  • Токен попал туда, где его быть не должно: сразу выберите Перевыпустить или Отозвать.

Что дальше