↑ API стандартизации

API стандартизации телефонов

✔️ Проверяет телефон.

✔️ Проставляет актуальный код города / DEF-код.

✔️ Восстанавливает оператора, регион и часовой пояс.

✔️ Учитывает переносы номера между операторами.

Как вызвать

Чтобы вызвать метод, зарегистрируйтесь и получите ключ

Пример запроса:

curl -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Token ${API_KEY}" \
    -H "X-Secret: ${SECRET_KEY}" \
    -d '[ "тел 7165219 доб139" ]' \
    https://dadata.ru/api/v2/clean/phone

Укажите при вызове:

  • Content-Type: application/json.
  • ${API_KEY} — API-ключ.
  • ${SECRET_KEY} — секретный ключ.

Тело запроса передавайте в кодировке UTF-8.

Что в ответе

Стандартизованные объекты:

[
{
    "source": "тел 7165219 доб139", 
    "type": "Стационарный", 
    "phone": "+7 495 716-52-19 доб. 139", 
    "country_code": "7", 
    "city_code": "495", 
    "number": "7165219", 
    "extension": "139", 
    "provider": "ПАО \"МГТС\"", 
    "region": "Москва", 
    "timezone": "UTC+3", 
    "qc_conflict": 0, 
    "qc": 1
}
]
НазваниеДлинаОписание
source 100 Исходный телефон одной строкой
type 50 Тип телефона
phone 50 Стандартизованный телефон одной строкой
country_code 5 Код страны
city_code 5 Код города / DEF-код
number 10 Локальный номер телефона
extension 10 Добавочный номер
provider 100 Оператор связи (только для России)
region 100 Регион (только для России)
timezone 10 Часовой пояс (только для России)
qc_conflict 5 Признак конфликта телефона с адресом
qc 5 Код проверки

Тип телефона

Тип Пример телефона
Мобильный +7 911 243-45-68
Стационарный +7 495 456-55-77
Прямой мобильный +7 495 243-45-68
Колл-центр 8 800 222-12-22
Неизвестный +7 333 1111112

Коды качества

Код проверки qc

Нужно ли вручную проверить распознанный телефон:

Код qc Описание Нужно проверить вручную?
0 Российский телефон, распознан уверенно Нет
7 Иностранный телефон, распознан уверенно Нет
2 Телефон пустой или заведомо «мусорный» Нет
1 Телефон распознан с допущениями или не распознан Да
3 Обнаружено несколько телефонов, распознан первый Да

Признак конфликта телефона с адресом qc_conflict

Указал ли клиент телефон, соответствующий его адресу. Удобно для проверки уровня риска:

Код qc_conflict Описание
0 Телефон соответствует адресу
2 Города адреса и телефона отличаются
3 Регионы адреса и телефона отличаются

Коды ответа на запрос

HTTP-код ответа Описание
200 Запрос успешно обработан
400 Некорректный запрос
401 В запросе отсутствует API-ключ или секретный ключ
Или в запросе указан несуществующий ключ
Или не подтверждена почта
402 Недостаточно средств для обработки запроса, пополните баланс
405 Запрос сделан с методом, отличным от POST
413 Запрос содержит более 10 записей
429 Слишком много запросов в секунду
5xx Произошла внутренняя ошибка сервиса

Ограничения

В запросе может быть до 10 записей.

Максимальная частота запросов:

  • 10 запросов/сек, если в запросе 1 запись;
  • 5 запросов/сек, если в запросе 2 записи;
  • 2 запроса/сек, если в запросе 5 записей;
  • 1 запрос/сек, если в запросе 10 записей.

Дадата не поддерживает вызов стандартизации из JavaScript. Иначе злоумышленник мог бы похитить секретный ключ и использовать стандартизацию за ваш счет.

Стоимость

5–10 копеек за запись, скидки за объём.

ajax-spinner

Обрабатывайте файлы, вызывайте API

первые 100 записей — бесплатно

чтобы обращаться к вам в письмах

Регистрируясь, вы принимаете публичную оферту

Уже зарегистрированы? Войти