Международное определение исходного оператора: проверка номеров в разных странах
Узнайте, как выполнять международное определение исходного оператора для списков номеров: форматирование, синхронные мультизапросы и пакетная обработка.
Практическое руководство по выполнению международного определения исходного оператора для списков номеров из разных стран: от форматирования E.164 до выбора между проверкой в реальном времени и пакетной обработкой файлов.
Международное определение исходного оператора работает наиболее эффективно, когда каждый номер представлен в формате E.164: с символом «плюс», кодом страны и номером абонента. CarrierLookup возвращает данные об операторе, которому номер был изначально выделен, а также тип линии и географию распределения. Проверки в реальном времени позволяют обрабатывать номера из разных стран в одном запросе, в то время как пакетные задачи (bulk file tasks) требуют выбора одной страны для каждого файла. Результат отражает контекст первоначального выделения номера, а не сеть, которая обслуживает его в настоящее время.
Начните с корректного формата E.164
Для любого международного определения исходного оператора необходимо наличие кода страны. Формат E.164 начинается с символа «плюс», за которым следуют код страны и номер абонента без пробелов, тире или скобок. Строку в национальном формате, например, номер, начинающийся с префикса выхода на междугороднюю связь, невозможно однозначно отнести к стране без предположений, поэтому перед проверкой такие номера следует преобразовать.
Краткий контрольный список подготовки для смешанного списка:
- Добавьте символ «плюс» и код страны к каждой строке.
- Удалите пробелы, знаки препинания и добавочные номера.
- Исключите очевидные заполнители и пустые строки.
- Сохраните исходный столбец с данными, чтобы можно было отследить отклоненные строки.
Отклоненный формат не означает отсутствие оператора. Это лишь указывает на то, что ввод не удалось распознать как номер, поэтому исправьте форматирование и повторите попытку.
Проверка списков из разных стран в реальном времени
Функция Определение исходного оператора в реальном времени не требует отдельного выбора страны, так как код страны уже содержится в каждом номере. Один номер обрабатывается через POST /api/v1/check, а синхронный мультизапрос — через POST /api/v1/batch-check (от 1 до 100 номеров), даже если они относятся к разным странам. Результаты возвращаются в порядке ввода, поэтому их можно сопоставить с исходными строками по позиции.
Панель управления предлагает ту же функцию мультипроверки в реальном времени для списков до 500 номеров, что удобно для аналитиков, которым нужно получить ответы на экране.
В ответе на мультизапрос для каждого элемента указывается, существует ли нормальный результат. Отсутствие нормального результата не является утверждением о том, что номер недействителен или отключен. Если время ожидания мультизапроса истекает, весь запрос считается неудачным без частичных результатов, а полная сумма возвращается на баланс.
Когда переходить к пакетной обработке файлов
Пакетные задачи (bulk file tasks) являются асинхронными и подходят для больших списков. Задача принимает файл TXT или CSV, содержащий по одному номеру с кодом страны в каждой строке, и выбранный код страны ISO. Поскольку задача привязана к конкретной стране, глобальный список следует сначала разделить по странам, а затем отправить как отдельные задачи.
Предварительная обработка исключает недействительные строки, дубликаты, номера без кода страны и номера вне выбранной страны. За исключенные строки плата не взимается. Задача проходит стадии обработки, success или failed, и успешная задача возвращает один CSV-файл для скачивания. Запрашивайте статус задачи не чаще, чем раз в 30 секунд.
Для размера файлов и количества номеров действуют ограничения, зависящие от продукта, поэтому ознакомьтесь с актуальной документацией API перед планированием очень большой загрузки.
Региональные примечания и значение выходных данных
Покрытие не везде одинаково. Одиночные проверки в реальном времени поддерживают материковый Китай (+86), Гонконг (+852) и Макао (+853) для небольших объемов, в то время как пакетные задачи эти регионы не поддерживают. Поддержка Тайваня (+886) не подтверждена, поэтому протестируйте небольшую выборку перед включением в план.
Быстрый способ выбора маршрута:
| Ситуация | Рекомендуемый путь |
|---|---|
| Несколько номеров из разных стран | Одиночная или мультипроверка в реальном времени |
| Список, скопированный командой | Мультипроверка через панель управления |
| Большой список из одной страны | Пакетная задача (bulk file task) |
| Материковый Китай, Гонконг или Макао | Только одиночные проверки в реальном времени |
При чтении результатов рассматривайте оператора как первоначального владельца диапазона, а регион и город — как географию распределения номерной емкости. Эти данные не описывают текущее местоположение абонента и не подтверждают, что номер может принимать вызовы или сообщения.
Часто задаваемые вопросы
Может ли один запрос содержать номера из разных стран?
Да, для синхронных мультизапросов. Мультизапрос принимает от 1 до 100 номеров в формате E.164, и они могут быть из разных стран. Пакетные задачи отличаются тем, что каждая задача строится вокруг одной выбранной страны, поэтому глобальный список следует разделить перед отправкой.
Как командам обрабатывать номера, для которых не возвращается нормальный результат?
Сохраняйте их в отдельный список для проверки. Команды могут повторно проверить форматирование, подтвердить источник номера и рассматривать столбец оператора как «неизвестно», а не как отрицательный результат.
Показывает ли международное определение исходного оператора текущую сеть?
Нет. CarrierLookup сообщает оператора, которому диапазон номеров был выделен изначально. После переноса номера в другую сеть (MNP) исходный оператор остается прежним. Результат полезен для сегментации и обогащения данных, а не для определения того, какая сеть обслуживает номер в данный момент.
Узнайте больше
Выберите информацию о продукте, соответствующую следующему шагу в вашем рабочем процессе.