API определения оператора по номеру

Авторизация

Коммерческие эндпоинты принимают API-ключ в заголовке X-API-Key. Демо-эндпоинт /v1/demo работает без ключа с лимитом 50 запросов в сутки с одного IP.

После подтверждения email и выпуска ключа аккаунт получает 300 бесплатных проверок без срока действия. Остаток сохраняется после оплаты и расходуется раньше платного баланса.

Первый успешный запрос по номеру тарифицируется. Повторные проверки этого номера тем же клиентом в течение 24 часов бесплатны независимо от API-ключа и выбранного коммерческого эндпоинта.

X-API-Key: n7_...

GET /v1/balance

Возвращает актуальный баланс аккаунта и количество доступных новых проверок. Запрос бесплатный, не изменяет баланс и использует тот же заголовок X-API-Key.

curl -H "X-API-Key: n7_..." \
  "https://num7.ru/v1/balance"

{
  "balance": "8307.91",
  "currency": "RUB",
  "remaining_requests": 830791,
  "price": "0.01"
}

balance передаётся строкой в рублях с двумя знаками после точки. remaining_requests учитывает цены всех активных пакетов; бесплатные повторы одного номера в течение 24 часов его не уменьшают. price рассчитывается как баланс, делённый на оставшиеся проверки, и округляется до копейки. При нулевом остатке значение price равно null.

GET /v1/lookup

Возвращает полную карточку номера. Параметр phone можно передавать в форматах +79261234567, 89261234567, 9261234567.

curl -H "X-API-Key: n7_..." \
  "https://num7.ru/v1/lookup?phone=+79261234567"

{
  "phone": "+79261234567",
  "operator": "МегаФон",
  "operator_slug": "megafon",
  "operator_inn": "7812014560",
  "region": "Москва и Московская область",
  "mnp_ported": false,
  "mcc": 250,
  "mnc": 2,
  "found": true
}

GET /v1/operator

Короткий ответ только с идентификатором оператора. Подходит для SMS-маршрутизации, биллинга и внутренних правил.

curl -H "X-API-Key: n7_..." \
  "https://num7.ru/v1/operator?phone=+79261234567"

{"operator": "megafon"}

Batch POST

POST /v1/lookup возвращает карточки номеров, POST /v1/operator возвращает только операторов. В одном запросе можно передать до 300 номеров.

curl -X POST "https://num7.ru/v1/lookup" \
  -H "X-API-Key: n7_..." \
  -H "Content-Type: application/json" \
  -d '{"phones":["+79261234567","89031234567"]}'

Также поддерживается тело в виде массива строк:

["+79261234567", "89031234567"]

Ошибки

Полезные страницы