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

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

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

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

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

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

Как вызвать

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

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

curl -X POST \
    -H "Content-Type: application/json" \
    -H "Authorization: Token ${API_KEY}" \
    -H "X-Secret: ${SECRET_KEY}" \
    -d '[ "раб 846)231.60.14 *139" ]' \
    https://dadata.ru/api/v2/clean/phone

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

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

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

Что в ответе

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

[
{
    "source": "раб 846)231.60.14 *139", 
    "type": "Стационарный", 
    "phone": "+7 846 231-60-14 доб. 139", 
    "country_code": "7", 
    "city_code": "846", 
    "number": "2316014", 
    "extension": "139", 
    "provider": "ООО \"СИПАУТНЭТ\"", 
    "country": "Россия", 
    "region": "Самарская область", 
    "city": "Самара", 
    "timezone": "UTC+4", 
    "qc_conflict": 0, 
    "qc": 0
}
]
НазваниеДлинаОписание
source 100 Исходный телефон одной строкой
type 50 Тип телефона
phone 50 Стандартизованный телефон одной строкой
country_code 5 Код страны
city_code 5 Код города / DEF-код
number 10 Локальный номер телефона
extension 10 Добавочный номер
provider 100 Оператор связи (только для России)
country 50 Страна
region 100 Регион (только для России)
city 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 Регионы адреса и телефона отличаются

Заполняется только для российских адресов. Для иностранных всегда равен 0.

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

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

Ограничения

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

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

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

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

Стоимость

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

ajax-spinner

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

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

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

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

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