01

Постійний API-ключ

Звичайний сценарій починається у Windows Складі.

Як отримати ключ

  1. 1
    Увійдіть до потрібної бази у програмі Windows Склад.
  2. 2
    Відкрийте меню «Інформація про ліцензію».
  3. 3
    Натисніть кнопку отримання API13-ключа та скопіюйте значення, що починається з a13k1..
  4. 4
    Збережіть ключ у захищеній конфігурації конкретного користувача інтеграції.
Не записуйте ключ у URL, журнали, аналітику, репозиторій або глобальну конфігурацію всіх користувачів. Передавайте його лише як Bearer credentials.

Адміністратор бази, без ролей API

Постійний ключ має серверний профіль адміністратора поточної бази. Ролі операторів Windows для нього не застосовуються: доступ визначає фіксований каталог API13.

Фактичний список методів, доступних поточному ключу, повертає POST /v1/operations.

Під час кожної видачі або відновлення ключа API13 перевіряє технічного користувача Api_user з ID 1313 у поточній базі та створює його, якщо запису ще немає. Конфлікт цього ID або імені з іншим користувачем блокує видачу ключа. Публічні методи API13 не дозволяють видалити або перейменувати цей технічний запис.

Поля автора legacy-записів API13 підставляє сервером як 1313. Передавати operator_id, user, user_id, log_user або batch_user у RPC не потрібно й не дозволено. Цільовий користувач чи консультант у конкретній бізнес-операції залишається окремим параметром.

У нових запитах приберіть operator_id та user_id. Починаючи з версії 0.6.1, API13 тимчасово приймає їх у методах старого контракту, перевіряє формат та ігнорує значення: фактичним автором усе одно буде 1313.

Звичайна повторна видача повертає чинний ключ і не ротирує його. При втраті або компрометації потрібна серверна заміна та відкликання старого ключа.
02

Два типи облікових даних

Не плутайте постійний ключ із коротким сеансовим токеном.

ФорматПризначенняСтрокДоступ
a13k1.…Ключ адміністратора для інтеграціїПостійний до ротаціїКаталог адміністративних методів API13
a13s1.…Результат POST /v1/auth/tokenКороткий сеансМінімальні методи читання згідно зі scopes