Доступ до API

Щоб почати інтеграцію з Identomat, вам знадобляться ключі API для автентифікації запитів

Отримання ключів API

• Перейдіть до розділу ключів API: Увійдіть у панель керування Identomat та оберіть API keys у меню, вкладеному в розділ Settings.

• Створіть ключ: У розділі API натисніть кнопку Generate key.

• Білий список IP-адрес (необов'язково): Ви можете обмежити ключ конкретним набором IP-адрес, щоб приймалися лише запити з цих IP — запити з будь-якої іншої IP-адреси будуть відхилені. Якщо жодних IP-адрес не додано, ключ прийматиме запити з будь-якої IP-адреси. IP-адреси в білому списку не фіксуються під час створення — ви можете додавати або видаляти їх у будь-який час у налаштуваннях ключа.

• ❗ Зберігайте безпечно: Скопіюйте створений ключ API та надійно збережіть його. З міркувань безпеки ключ буде показано лише один раз. Якщо ви його втратите, доведеться створити новий.

💡 HMAC-авторизація: Для підвищення безпеки ви можете реалізувати HMAC-авторизацію, використовуючи ваш секретний ключ як ключ шифрування. Це необов'язково, але рекомендовано для продакшн-середовищ.

Процедура

Процедура інтеграції складається з таких кроків:

1. Отримання session_token.

2. Перенаправлення браузера користувача на widget.identomat.com.

3. Перевірка результату. Щоб отримати session_token, сервер компанії має викликати ендпоінт /begin та надати такі аргументи: company_key, flags та steps. Масив steps містить конфігурацію окремих кроків процесу ідентифікації, кожен з яких може мати власний набір прапорців (flags), специфічних для цього кроку. Ендпоінт, що використовується для створення session_token:

https://widget.identomat.com/begin/

Детальніше див.:

Посібник для розробників

Покрокові інструкції та найкращі практики для інтеграції та налаштування наших рішень з верифікації особи.

Довідник API

Вичерпні відомості про ендпоінти, параметри та формати відповідей для безперешкодної інтеграції API.