Проверка трех элементов номера телефона API: инструкция по интеграции

В этой статье будет представлена инструкция по интеграции 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",
  "description": "Аутентификация пройдена",
  "isp": "Мобильный",
  "result_detail": null
}

Возвращаемый результат содержит несколько полей, описание которых приведено ниже:

result, код результата аутентификации, условия оплаты следующие.
- Платные коды результата:
  - 0: Результат проверки совпадает
  - 1: Результат проверки не совпадает
- Бесплатные коды результата:
  - -1: Запись не найдена
  - -2: Неизвестная ошибка движка
  - -3: Аномалия в работе сервиса движка
  - -4: Проверка имени не пройдена
  - -5: Номер телефона недействителен
  - -6: Количество аутентификаций превышает дневное ограничение, попробуйте снова на следующий день
description, описание бизнес-результата.

Можно увидеть, что информация о подлинности и согласованности номера телефона, имени и номера удостоверения личности уже была запрошена. Кроме того, если вы хотите сгенерировать соответствующий код интеграции, вы можете просто скопировать его, например, код CURL выглядит следующим образом:

curl -X POST 'https://api.acedata.cloud/identity/phone/check-3e' \
-H 'accept: application/json' \
-H 'authorization: Bearer {token}' \
-H 'content-type: application/json' \
-d '{
  "name": "***",
  "phone": "***",
  "id_card": "***"
}'

Код интеграции на Python выглядит следующим образом:

import requests

url = "https://api.acedata.cloud/identity/phone/check-3e"

headers = {
    "accept": "application/json",
    "authorization": "Bearer {token}",
    "content-type": "application/json"
}

payload = {
    "name": "***",
    "phone": "***",
    "id_card": "***"
}

response = requests.post(url, json=payload, headers=headers)
print(response.text)

Обработка ошибок

При вызове API, если возникнет ошибка, API вернет соответствующий код ошибки и информацию. Например:

400 token_mismatched: Неверный запрос, возможно, из-за отсутствующих или недействительных параметров.
400 api_not_implemented: Неверный запрос, возможно, из-за отсутствующих или недействительных параметров.
401 invalid_token: Неавторизовано, недействительный или отсутствующий токен авторизации.
429 too_many_requests: Слишком много запросов, вы превысили лимит частоты.
500 api_error: Внутренняя ошибка сервера, что-то пошло не так на сервере.

Пример ответа об ошибке

{
  "success": false,
  "error": {
    "code": "api_error",
    "message": "не удалось получить данные"
  },
  "trace_id": "2cf86e86-22a4-46e1-ac2f-032c0f2a4e89"
}

Заключение

С помощью этого документа вы узнали, как использовать API проверки трех элементов номера телефона для проверки подлинности и согласованности номера телефона, имени и номера удостоверения личности. Надеемся, что этот документ поможет вам лучше интегрировать и использовать данный API. Если у вас есть какие-либо вопросы, пожалуйста, не стесняйтесь обращаться в нашу техническую поддержку.

Начало работы

AI Чат

AI Изображение

AI Видео

AI Аудио

Веб и данные

CAPTCHA

Идентичность

Прокси

Продвинутый

Coding

Проверка трех элементов номера телефона API: инструкция по интеграции

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

Основное использование

Обработка ошибок

Пример ответа об ошибке

Заключение

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

​Основное использование

​Обработка ошибок

​Пример ответа об ошибке

​Заключение

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

Основное использование

Обработка ошибок

Пример ответа об ошибке

Заключение