Команда и администрирование
Токены API
Программы, скрипты и автоматизации управляют Sealed Print с помощью токена API.
Токен API даёт программе доступ к REST API Sealed Print, например чтобы отслеживать задания, управлять назначениями или читать очередь из скрипта. Токен действует от имени человека, который его создал, с правами не выше его собственных и только в той организации, где он был создан. Справочник API описывает все эндпоинты с примерами.
Предварительные условия
- Любой участник может создавать токены в сеансе браузера. Администраторы видят все токены организации и могут их отзывать.
- Токены управляют Sealed Print: заданиями, источниками, назначениями и настройками. Они не могут отправлять задания; вместо этого программы отправляют документы на API-эндпоинт.
- Входит в каждый тариф.
Однократная настройка
- Перейдите в Настройки → Токены API и выберите Новый токен.
- Введите Название, которое говорит, для чего используется токен, например «Экспорт счетов в бухгалтерию».
- Выберите Права: пользователь (ваши собственные источники, назначения и задания), администратор или владелец, но не выше вашей собственной роли.
- Выберите Срок действия: 7, 30 или 90 дней, 1 год, собственная дата или без срока.
- Выберите Создать и скопируйте токен. Токен показывается только сейчас; сохраните его в надёжном месте, например в менеджере паролей.
Отправляйте токен с каждым запросом в заголовке 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-эндпоинт. - Токен внезапно перестал работать: токены становятся недействительными, когда создавший их человек покидает организацию. Создайте новый токен от имени другого участника.
- Токен попал туда, где его быть не должно: сразу выберите Перевыпустить или Отозвать.
Что дальше
- Справочник API: все эндпоинты с описанием OpenAPI.
- API-эндпоинты
- Входящие и исходящие каналы