Skip to main content
У цьому документі буде представлено інструкцію з інтеграції API перевірки трьох елементів номера телефону, яка може бути використана для перевірки достовірності та узгодженості номера телефону, імені та номера посвідчення особи.

​
Процес подачі заявки

Щоб використовувати API перевірки трьох елементів номера телефону, спочатку перейдіть до консолі Ace Data Cloud, щоб отримати ваш API Token, залиште його на випадок потреби. Якщо ви ще не увійшли в систему або не зареєстровані, вас автоматично перенаправлять на сторінку входу, щоб запросити реєстрацію та вхід, після чого ви будете автоматично повернені на поточну сторінку. Один API Token дозволяє викликати всі послуги платформи, не потрібно окремо запитувати для кожної послуги. Перший запит надає безкоштовний ліміт, щоб ви могли безкоштовно протестувати; якщо ліміт вичерпано, ви можете поповнити загальний баланс в консолі.
📘 Повна документація: API перевірки трьох елементів номера телефону →

​
Основне використання

Спочатку ознайомтеся з основним способом використання, тобто введіть номер телефону, щоб отримати оброблений результат, спочатку потрібно просто передати поле phone. Далі ми можемо заповнити відповідні дані на інтерфейсі, як показано на малюнку:

Ми бачимо, що тут ми налаштували заголовки запиту, включаючи:
  • accept: вкажіть, у якому форматі ви хочете отримати відповідь, тут вказано application/json, тобто формат JSON.
  • authorization: ключ для виклику API, після запиту ви можете вибрати його зі списку.
Також налаштовано тіло запиту, яке включає:
  • name: ім’я користувача, яке потрібно обробити, є обов’язковим параметром.
  • phone: номер телефону, який потрібно обробити, є обов’язковим параметром.
  • id_card: номер посвідчення особи користувача, який потрібно обробити, є обов’язковим параметром.
  • verify_mode: режим перевірки (довгий/короткий).
  • encrypt_list/ciphertext_blob/iv: необов’язкові параметри шифрування, за потреби шифруйте чутливі поля.
Після вибору ви також можете побачити згенерований код праворуч, як показано на малюнку:

Натисніть кнопку «Спробувати», щоб провести тестування, як показано на малюнку, тут ми отримали наступний результат:
Повернуті результати містять кілька полів, описаних нижче:
  • result, код результату аутентифікації, умови оплати такі:
    • Код результату оплати:
      • 0: Результат перевірки узгоджений
      • 1: Результат перевірки неузгоджений
    • Код результату без оплати:
      • -1: Запис не знайдено
      • -2: Невідома помилка двигуна
      • -3: Аномалія служби двигуна
      • -4: Перевірка імені не пройшла
      • -5: Номер телефону недійсний
      • -6: Кількість аутентифікацій перевищує добове обмеження, будь ласка, спробуйте наступного дня
  • description, опис бізнес-результату.
Можна побачити, що інформація про достовірність та узгодженість номера телефону, імені та номера посвідчення особи вже запитана. Крім того, якщо ви хочете згенерувати відповідний код інтеграції, ви можете просто скопіювати його, наприклад, код CURL виглядає так:
Код інтеграції на Python виглядає так:

​
Обробка помилок

При виклику API, якщо виникає помилка, API поверне відповідний код помилки та інформацію. Наприклад:
  • 400 token_mismatched: Неправильний запит, можливо, через відсутні або недійсні параметри.
  • 400 api_not_implemented: Неправильний запит, можливо, через відсутні або недійсні параметри.
  • 401 invalid_token: Неавторизовано, недійсний або відсутній токен авторизації.
  • 429 too_many_requests: Занадто багато запитів, ви перевищили ліміт запитів.
  • 500 api_error: Внутрішня помилка сервера, щось пішло не так на сервері.

​
Приклад відповіді з помилкою

​
Висновок

Завдяки цьому документу ви дізналися, як використовувати API перевірки трьох елементів номера телефону для перевірки достовірності та узгодженості номера телефону, імені та номера посвідчення особи. Сподіваємося, що цей документ допоможе вам краще інтегрувати та використовувати цей API. Якщо у вас є будь-які питання, будь ласка, звертайтеся до нашої команди технічної підтримки.