Skip to main content
В этой статье будет представлено описание интеграции API для проверки статуса номера телефона, который можно использовать для проверки состояния номера телефона, вы можете ввести номер телефона для запроса.

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

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

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

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

Как видно, мы настроили заголовки запроса, включая:
  • accept: в каком формате вы хотите получить ответ, здесь указано application/json, то есть в формате JSON.
  • authorization: ключ для вызова API, после запроса можно выбрать из выпадающего списка.
Также настроено тело запроса, включая:
  • mobile: номер телефона, который нужно обработать, обязательный параметр.
  • encryption: необязательный параметр для шифрования чувствительных данных (если необходимо отправить зашифрованный текст).
После выбора можно заметить, что справа также сгенерирован соответствующий код, как показано на изображении:

Нажмите кнопку «Попробовать», чтобы провести тестирование, как показано на изображении, здесь мы получили следующий результат:
Возвращаемый результат содержит несколько полей, описание которых приведено ниже:
  • result, код результата проверки, условия оплаты следующие.
    • Код результата с оплатой:
      • 0: Успешно
    • Код результата без оплаты:
      • -1: Результат не найден
      • -2: Неправильный формат номера телефона
      • -3: Служба проверки занята
  • description, описание результата бизнеса.
  • status_code, код состояния:
    • 0: Нормально
    • 1: Отключен
    • 2: Номер аннулирован
    • 3: Пустой номер
    • 4: Не в сети
    • 99: Неизвестный статус
Можно увидеть, что статус этого номера телефона уже был проверен. Кроме того, если вы хотите сгенерировать соответствующий код интеграции, вы можете просто скопировать его, например, код CURL выглядит следующим образом:
Код интеграции на Python выглядит следующим образом:

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

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

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

​
Заключение

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