POST /api/v1/checkcurl -X POST "https://carrierlookup.online/api/v1/check" \
-H "X-API-Key: sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "service_type": "carrier", "identifier": "+17253100591" }'service_type carrier
Узнайте, какому оператору номер был изначально выделен, а также тип линии и местоположение.
POST /api/v1/checkВход не требуется.
Контракт API
Отправьте один номер и выберите этот продукт с помощью service_type. Для аутентификации используется ваш ключ API.
Скопируйте команду curl ниже и замените только пример ключа API на свой.
POST /api/v1/checkcurl -X POST "https://carrierlookup.online/api/v1/check" \
-H "X-API-Key: sk_your_api_key" \
-H "Content-Type: application/json" \
-d '{ "service_type": "carrier", "identifier": "+17253100591" }'200 OK{
"code": 0,
"msg": "ok",
"data": {
"service_type": "carrier",
"identifier": "+17253100591",
"carrier": "T-Mobile",
"underlying_carrier": "",
"number_type": "Fixed Line or Mobile",
"country_code": "US",
"region": "NV",
"city": "LAS VEGAS"
}
}Как использовать
Отправьте номер в формате E.164: знак плюс, код страны, затем номер абонента без пробелов и разделителей — например, +17253100591.
Панель SaaS и синхронный API возвращают ответ одинаковой структуры с исходным оператором и связанными полями.
Успешный ответ возвращает поля оператора синхронно. Они описывают исходное выделение номера, которое перенос номера не меняет, поэтому повторный запрос не покажет более позднего оператора. Согласие на контакт получайте отдельно.
Что проверяется
carrier · string — Оператор, которому номер был изначально выделен. Не текущий оператор после переноса.underlying_carrier · string — Базовый оператор, сообщённый поставщиком данных, если он отличается от выделенного; пустая строка, если поставщик его не предоставляет.number_type · string — Тип линии, сообщённый поставщиком данных; пусто, если недоступен.country_code · string — Код страны ISO, к которой относится номер.region · string — Регион выделения; пусто, если поставщик его не предоставляет.city · string — Город выделения; пусто, если поставщик его не предоставляет.Лучше всего подходит для
Узнайте исходного оператора номера и тип линии, прежде чем применять собственные правила маршрутизации.
Записывайте исходного оператора и регион выделения в модели затрат или записи о закупках, чтобы оценивать ожидаемые расходы по диапазонам номеров.
Сравнивайте выделение, страну и регион номера с существующими контактными записями, чтобы находить отсутствующие или противоречивые данные.
Группируйте списки номеров по исходному оператору, типу линии и региону выделения, чтобы у дальнейшей работы с данными были чёткие измерения.
Краткий ответ
Определение исходного оператора возвращает оператора, которому номер был изначально выделен, тип линии и регион, к которому он относится. Укажите service_type carrier (параметр, выбирающий продукт) и один номер в формате E.164, например +17253100591, и прочитайте поля оператора в том же ответе API.
Чёткие границы
FAQ по продукту
Проверяется один номер, и в том же синхронном ответе возвращается оператора, которому номер был изначально выделен, тип линии и регион, к которому он относится.
Баланс списывается только за завершённые проверки. За неудачные или неопределённые проверки средства не удерживаются.
Отправьте один номер в формате E.164, например +17253100591. Код страны входит в номер, поэтому отдельно выбирать страну не нужно.
Нет. Результат сообщает только сеть, которой номер был изначально выделен; перенос номеров не учитывается, и доступность номера из него не следует. Согласие и соблюдение применимых правил остаются вашей ответственностью.
Создайте аккаунт, чтобы пользоваться всеми продуктами из панели SaaS или через API: проверки в реальном времени и асинхронные массовые проверки расходуют один и тот же баланс.