Усі посібники

Команда та адміністрування

Токени 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.
  • Токен раптом перестає працювати: токени стають недійсними, коли людина, яка їх створила, виходить з організації. Створіть новий токен від імені іншого учасника.
  • Токен скопійовано туди, де його не повинно бути: негайно виберіть Перевипустити або Відкликати.

Що далі