Перейти до основного вмісту

Як це працює

Перевірка — це один запит на вході й один вердикт на виході. Ця сторінка проводить від одного до другого, щоб ви знали, що відбувається між ними і на що можна покладатися згодом.

Шлях перевірки​

  1. Ваш бекенд надсилає перевірку. Перевірку адреси або перевірку транзакції, автентифіковану ключем API.
  2. Запит приймається або відхиляється наперед. Ключ, його scope, обмеження частоти запитів і ліміт чи попередньо поповнений баланс перевіряються до початку скринінгу. Відхилений запит повертає помилку і ніколи не тарифікується.
  3. Рушій скринінгу збирає знахідки. Він зіставляє адресу з публічними офіційними списками й власним набором міток Leeri, простежує рух коштів через контрагентів адреси для активів із повним покриттям і використовує стороннє джерело даних, коли воно доступне. Кожна знахідка називає своє джерело.
  4. Вердикт виводиться й закріплюється. Знахідки зважуються опублікованим набором правил в оцінку й рівень ризику. Вердикт фіксує версію набору правил, знімок міток і висоту ланцюга, за якими його виведено, тож його можна відтворити пізніше.
  5. Ви отримуєте відповідь, звіт і, якщо зареєстровано, вебхук. Відповідь містить вердикт. Доказовий звіт до нього входить у перевірку, а вебхук доставляє check.completed, щойно перевірка остаточна.

Синхронно чи pending​

Більшість перевірок відповідає в тій самій відповіді. Коли перевірці потрібно більше часу, ніж має тримати запит, API приймає її й відповідає status: "pending" з тією самою формою тіла та check_id. Вердикт створюється у фоні. Результат читайте опитуванням або, краще, вебхуком: див. Pending та опитування. У pending-перевірки ще немає вердикту, вона не тарифікується й не надсилає вебхук завершення; усе фіксується один раз, коли вона завершується.

Часткові вердикти​

Якщо джерело даних недоступне, перевірка не завершується серверною помилкою й не вдає чистої. Вона повертає частковий вердикт, який каже, що він частковий, і перелічує причини. Частковий вердикт через збій не тарифікується, і перевірку можна повторити пізніше. Частковий вердикт, що лише фіксує межу аналізу, наприклад глибину обходу для активу, — це повноцінна послуга для цієї адреси, і він тарифікується. Правила тарифікації — у Обмеження частоти запитів і ліміти, поля — в Перевірках адрес.

Sandbox і live​

Середовище визначає ключ. Ключ sandbox запускає той самий рушій на ваших власних даних без витрати ліміту чи балансу, з нижчим обмеженням частоти запитів, і має спеціальну тестову адресу, що завжди відповідає pending. Ключ live тарифікується. Більше нічого не змінюється під час переходу. Див. Sandbox і live.

Що зберігає Leeri і навіщо​

Вердикт зберігається як його знахідки та посилання на докази за ними разом із pin, а не як голе число. Саме це робить вердикт зрозумілим і відтворюваним через місяці: Rederive відтворює його за набором правил і знімком міток, з якими його видано, а доказовий звіт можна перевірити на справжність. Відповіді сторонніх джерел даних стають джерельними записами у власному наборі міток Leeri; нічого про ваш обліковий запис, ваших клієнтів чи вашу перевірку разом із ними не зберігається.

Далі​