DaData: автозаполнение и проверка адресов, ИНН, телефонов в форме

В твоём приложении есть форма заказа с адресом доставки. Пользователь вводит «москва ленинградский проспект 15» — но забывает указать подъезд, пишет «проспект» с маленькой буквы и вместо «дом» ставит слэш. В другой форме нужно ввести ИНН организации: 10 цифр, легко ошибиться. Или телефон: пользователь пишет его в разных форматах, иногда без кода страны, иногда с лишними скобками. Вручную проверить всё это невозможно, а ошибки в адресах и реквизитах оборачиваются недоставленными посылками, отказами в оплате и лишними звонками в поддержку. Здесь на помощь приходит DaData — российский сервис, который умеет подсказывать адреса, проверять ИНН и стандартизировать телефоны прямо в форме. Ниже — как он работает, чем отличается от обычной проверки форм и как подключить его к своему проекту.

Какая проблема решается DaData

Любое приложение с формами сталкивается с одними и теми же трудностями.

Адреса. Пользователи пишут адреса по-разному: «ул. Ленина», «улица Ленина», «Ленина ул.», «Ленина, 5», «Ленина 5 кв 12». Компьютеру не очевидно, что это один и тот же адрес. А если речь идёт о доставке, нужен стандартизированный адрес с индексом, районом и корректными сокращениями.

ИНН и реквизиты организаций. ИНН — это 10 или 12 цифр. Ошибка в одной цифре делает документ недействительным. Кроме того, по ИНН часто нужно узнать название организации, её адрес, ОГРН и руководителя. Вводить всё это вручную — долго и рискованно.

Телефоны. Пользователи пишут телефоны как попало: «8-999-123-45-67», «+7 999 123 45 67», «89991234567», «+7(999)123-45-67». Для отправки SMS или звонков в CRM нужен единый формат с кодом страны.

Email и ФИО. Даже имя и фамилия могут писаться с ошибками, а email — с опечатками в домене.

Обычная проверка формы может сказать: «Поле обязательно для заполнения» или «Введите корректный email». Но она не может проверить, реально ли существует такой адрес или ИНН. DaData как раз берёт на себя проверку содержания по внешним справочникам.

Что такое DaData

DaData — это российский сервис подсказок и стандартизации данных. Он работает через API: ты отправляешь ему часть введённого текста, а он возвращает варианты подсказок или результат проверки.

Например, пользователь начинает вводить адрес: «москва ленинград». Приложение отправляет этот текст в DaData, и сервис возвращает список подходящих адресов: «г Москва, Ленинградский проспект», «г Москва, Ленинградское шоссе» и так далее. Пользователь выбирает нужный вариант, и в базу сохраняется уже стандартизированный адрес.

Для ИНН работает иначе. Пользователь вводит 10 цифр, приложение отправляет запрос в DaData, и сервис возвращает информацию об организации: название, адрес, ОГРН, статус активности. Если ИНН не существует, DaData сообщает об этом.

Для телефона DaData приводит номер к единому формату, определяет оператора и регион, проверяет корректность.

Важно: DaData — платный сервис с лимитами на количество запросов. Конкретные тарифы нужно смотреть на официальном сайте dadata.ru, потому что они меняются.

Чем DaData отличается от обычной валидации форм

В статье про формы с валидацией мы разбирали, как проверять формат данных: заполнено ли поле, есть ли символ @ в email, совпадают ли пароли. Это важный первый уровень проверки, но он не отвечает на вопрос: «А реально ли такой адрес или ИНН существуют?»

Эти два уровня проверки дополняют друг друга. Сначала форма проверяет формат: пользователь что-то ввёл, email похож на email, телефон содержит цифры. Затем DaData проверяет содержание: реально ли существует такой адрес, ИНН, телефон. Только вместе они дают качественные данные.

Простая аналогия: обычная валидация — это проверка, что в конверте есть письмо и на нём написан адрес. DaData — это проверка, что по этому адресу действительно живёт человек, и исправление опечаток в адресе.

Практические примеры использования

DaData полезен в любой форме, где пользователь вводит адреса, реквизиты или контактные данные. Вот типичные сценарии.

Форма заказа с доставкой

Пользователь вводит адрес доставки. Вместо того чтобы писать адрес целиком и допускать ошибки, он начинает печатать, а DaData предлагает варианты. После выбора адрес сохраняется в стандартном виде: индекс, регион, город, улица, дом, квартира. Это снижает количество ошибок и ускоряет обработку заказов.

Регистрация бизнес-аккаунта

Компания вводит свой ИНН. DaData проверяет, существует ли такая организация, и подставляет название, адрес, ОГРН, КПП и руководителя. Пользователю не нужно вводить всё вручную, а тебе не нужно проверять справочники самостоятельно.

Форма обратной связи

Пользователь оставляет телефон для связи. DaData приводит номер к единому формату, проверяет код страны и оператора. Если номер некорректный, форма сразу предупреждает об этом.

Сбор адресов для рассылок

Если приложение отправляет корреспонденцию по адресам клиентов, важно, чтобы адреса были стандартизированы. DaData помогает привести адреса к единому формату и проверить их по официальному справочнику ФИАС.

Поиск по организациям

Если в приложении нужно найти компанию по названию или ИНН, DaData может подсказывать варианты по части названия. Это удобно для форм, где пользователь ищет контрагента или партнёра.

Автозаполнение ФИО

DaData умеет подсказывать имя, фамилию и отчество по частичному вводу. Это полезно в формах регистрации, оформления документов и заявок. Сервис также может определять пол и склонять ФИО по падежам.

Как подключить DaData к приложению

Подключение DaData происходит через API. Общий путь выглядит так:

1. Регистрация и получение API-ключа. Заходишь в личный кабинет на dadata.ru, регистрируешься и создаёшь API-ключ. Этот ключ нужен для всех запросов к сервису.

2. Хранение ключа в переменных окружения. API-ключ — секрет. Его нельзя вставлять прямо в код и коммитить в git. Нужно хранить в переменных окружения, например в файле .env, который не попадает в репозиторий. В коде ключ читается из переменной окружения.

3. Отправка запроса из приложения. Когда пользователь вводит текст, приложение отправляет запрос на сервер DaData с частью текста и API-ключом в заголовке. Сервер возвращает список подсказок или результат проверки.

4. Обработка ответа. Приложение показывает пользователю подсказки или сообщает об ошибке. Выбранный вариант сохраняется в базу данных.

Пример на псевдокоде для подсказок по адресу:

const response = await fetch('https://suggestions.dadata.ru/suggestions/api/4_1/rs/suggest/address', {
  method: 'POST',
  headers: {
    'Content-Type': 'application/json',
    'Accept': 'application/json',
    'Authorization': 'Token ' + process.env.DADATA_API_KEY
  },
  body: JSON.stringify({ query: 'москва ленинградский' })
});

const data = await response.json();
// data.suggestions содержит варианты адресов

Для проверки ИНН endpoint будет другой. Конкретные адреса endpoint'ов и форматы запросов лучше смотреть в официальной документации DaData, потому что они могут обновляться.

Как работают подсказки в реальном времени

Когда пользователь вводит адрес, подсказки обычно появляются по мере печатания. Это называется автодополнением. Работает это так:

1. Пользователь ввёл первые несколько букв: «моск».
2. Приложение ждёт небольшую паузу, чтобы не слать запрос на каждую букву.
3. После паузы приложение отправляет запрос в DaData с текстом «моск».
4. DaData возвращает варианты: «г Москва», «Московская обл» и другие.
5. Приложение показывает выпадающий список подсказок.
6. Пользователь выбирает вариант, и в форму подставляется стандартизированное значение.

Такой подход экономит запросы и делает форму удобной. Но важно не слать слишком много запросов — каждый запрос расходует лимит. Обычно используют задержку в 200–500 миллисекунд после последнего введённого символа.

Также важно обрабатывать ситуацию, когда DaData временно недоступен. Форма не должна ломаться, если подсказки не загрузились. Пользователь должен иметь возможность ввести адрес вручную.

Почему DaData — не обязательный инструмент для любого приложения

DaData полезен, но не универсален. Если в приложении нет форм с адресами, ИНН или телефонами, подключать сервис нет смысла. Это лишняя зависимость, лишние запросы по сети и лишние расходы.

Когда DaData действительно нужен:

• в форме заказа есть адрес доставки;
• приложение работает с организациями и их реквизитами;
• важна точность контактных данных, особенно для SMS и звонков;
• нужно стандартизировать адреса перед передачей в логистику или CRM.

Когда DaData не нужен:

• в форме только имя, email и сообщение;
• приложение не связано с доставкой или юридическими лицами;
• адреса и телефоны используются только для отображения, а не для реальных рассылок или звонков.

Важно не добавлять DaData «на всякий случай». Лучше сначала сделать простую валидацию форм, а DaData подключить тогда, когда появится реальная задача с адресами или реквизитами.

Безопасность и хранение API-ключа

API-ключ DaData даёт доступ к платному сервису. Если ключ попадёт к злоумышленникам, они смогут делать запросы за твой счёт. Поэтому безопасность критически важна.

Никогда не коммить ключ в git. Если ключ окажется в открытом репозитории, его смогут украсть боты за минуты. Всегда храни ключ в переменных окружения.

Не отдавай ключ на фронтенд. Если запросы к DaData делаются из браузера пользователя, ключ становится видимым. Лучше делать запросы через свой бэкенд, который хранит ключ на сервере.

Ограничивай доступ к ключу в личном кабинете. Некоторые сервисы позволяют настроить, с каких IP-адресов можно использовать ключ. Это дополнительная защита.

Следи за расходом лимитов. В личном кабинете можно посмотреть, сколько запросов сделано. Если цифра резко выросла, возможно, ключ скомпрометирован.

Если в курсе есть материал про хранение секретов, следуй ему. Если нет — запомни главное: секреты хранятся в переменных окружения, а не в коде.

Связь с базой данных

После того как пользователь выбрал подсказку, стандартизированное значение сохраняется в базу данных. Важно сохранять не только текст адреса, но и отдельные поля: индекс, регион, город, улицу, дом, квартиру. Это упрощает дальнейшую работу: поиск заказов по городу, фильтрацию по региону, передачу данных в службу доставки.

Для ИНН полезно сохранить не только сам номер, но и данные организации, которые вернул DaData: название, ОГРН, адрес. Тогда не придётся делать лишние запросы в будущем.

При проектировании таблицы стоит заранее подумать, какие поля понадобятся. Например, для адреса доставки полезны отдельные колонки: postal_code, region, city, street, house, apartment. Для организации: inn, kpp, ogrn, company_name, company_address. Тогда данные легко использовать в отчётах, фильтрах и интеграциях.

Ограничения и честные минусы

У DaData, как у любого сервиса, есть ограничения.

Платность. Хотя у сервиса есть бесплатный или тестовый доступ с лимитами, регулярное использование обычно требует оплаты. Конкретные условия смотри на сайте.

Зависимость от внешнего сервиса. Если DaData временно недоступен или изменит API, приложение должно корректно обрабатывать ситуацию. Например, позволять пользователю ввести адрес вручную, если подсказки не загрузились.

Не все адреса есть в справочнике. Особенно это касается новых домов, дачных посёлков и нестандартных адресов. В таких случаях DaData может не найти подсказку, и пользователю придётся вводить адрес самостоятельно.

Качество данных зависит от страны. DaData специализируется на российских адресах, организациях и телефонах. Если приложение работает с международными адресами, понадобятся другие сервисы.

Не заменяет здравый смысл пользователя. Даже если DaData подсказал адрес, пользователь может выбрать не тот вариант. Поэтому важно давать возможность проверить и отредактировать результат.

DaData в контексте вайбкодинга

Если ты проходишь курс по вайбкодингу и используешь Claude Code для написания кода, подключение DaData — хороший пример задачи, которую можно описать словами. Ты говоришь ассистенту: «Подключи автодополнение адресов через DaData. Когда пользователь вводит адрес, показывай подсказки. При выборе сохраняй стандартизированный адрес в базу. API-ключ бери из переменных окружения».

Claude Code сможет написать код запроса к API, обработку ответа, компонент подсказок и сохранение в базу. Тебе не нужно самому писать каждую строчку. Но важно понимать, как работает сервис, чтобы правильно поставить задачу и проверить результат.

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

Тестирование интеграции с DaData

После подключения DaData важно протестировать разные сценарии.

Проверь корректные данные. Введи реальный адрес, ИНН и телефон. Убедись, что подсказки появляются и выбранный вариант сохраняется правильно.

Проверь некорректные данные. Введи вымышленный ИНН или несуществующий адрес. Приложение должно сообщить об ошибке или дать возможность ввести данные вручную.

Проверь работу без интернета или при ошибке DaData. Отключи сеть или используй неверный ключ. Форма не должна падать. Подсказки могут не работать, но основная отправка формы должна оставаться возможной.

Проверь лимиты запросов. Если пользователь быстро печатает, убедись, что приложение не шлёт запрос на каждую букву. Используй задержку или минимальную длину введённого текста.

Подсказки по адресу: как это выглядит для пользователя

Когда пользователь начинает вводить адрес, приложение может показать выпадающий список с вариантами. Например, он ввёл «москва арбат». DaData возвращает несколько вариантов: «г Москва, ул Арбат», «г Москва, Арбатская пл», «г Москва, Новый Арбат ул» и так далее. Пользователь выбирает нужный пункт, и в форму автоматически подставляются отдельные поля.

После выбора приложение получает не только текстовое представление адреса, но и структурированные данные: индекс, код региона, название района, координаты, код КЛАДР и ФИАС. Это позволяет валидировать адрес на уровне деталей и передавать его в службу доставки в нужном формате.

Важный нюанс: DaData подсказывает адреса по официальному справочнику ФИАС. Если адрес ещё не внесён в справочник, подсказки не появятся. Поэтому в интерфейсе всегда должна оставаться возможность ручного ввода.

Проверка ИНН и реквизитов организации

Проверка ИНН — одна из самых востребованных функций DaData. Пользователь вводит 10 или 12 цифр, а сервис возвращает полную информацию о юридическом лице или индивидуальном предпринимателе.

Для юридических лиц ИНН состоит из 10 цифр. DaData может вернуть ОГРН, КПП, полное и краткое название организации, юридический адрес, дату регистрации, статус активности, сведения о руководителе и учредителях.

Для индивидуальных предпринимателей ИНН состоит из 12 цифр. DaData возвращает ФИО, ОГРНИП, дату регистрации и статус.

Это экономит время пользователя и снижает количество ошибок. Вместо того чтобы вручную заполнять десяток полей, он вводит один номер, а остальное подставляется автоматически.

Стандартизация телефонов

Телефонные номера пользователи вводят в самых разных форматах. Кто-то пишет восьмёрку в начале, кто-то плюс семь, кто-то добавляет скобки и дефисы. DaData приводит любой вариант к единому формату: +7 999 123-45-67.

Кроме форматирования, DaData может определить оператора связи, регион и даже проверить, является ли номер мобильным. Это полезно, если приложение отправляет SMS и нужно убедиться, что номер подходит.

Если пользователь ввёл номер с опечаткой или несуществующим кодом, DaData вернёт статус ошибки. Тогда форма может предупредить пользователя до отправки.

Автозаполнение ФИО и email

DaData умеет не только адреса и организации. Сервис подсказывает ФИО по частичному вводу. Например, пользователь ввёл «Иванов Ива», и DaData предлагает «Иванов Иван Иванович», «Иванов Иван Петрович» и другие варианты. Это ускоряет заполнение форм и снижает количество опечаток.

Для email DaData может проверить формат и домен, а также подсказать, если пользователь, вероятно, опечатался. Например, если введено «user@yandex.r», сервис может предложить «user@yandex.ru».

Эти возможности менее критичны, чем адреса и ИНН, но в комплексе делают формы значительно дружелюбнее.

Какие ошибки чаще всего допускают при интеграции

Ошибка 1: хранить ключ в коде. API-ключ должен быть в переменных окружения, а не в исходниках. Иначе он может случайно попасть в открытый репозиторий.

Ошибка 2: делать запросы из браузера. Если ключ виден в браузере, его могут украсть. Запросы к DaData должны идти через твой бэкенд.

Ошибка 3: не обрабатывать отсутствие подсказок. Не все адреса есть в справочнике. Форма не должна блокировать отправку, если DaData ничего не нашла.

Ошибка 4: слать слишком много запросов. Каждый введённый символ не должен вызывать запрос. Используй задержку и минимальную длину ввода.

Ошибка 5: сохранять только текст адреса. Полезно сохранять отдельные поля адреса, чтобы потом фильтровать и анализировать заказы.

DaData и другие сервисы подсказок

DaData — не единственный сервис подсказок в России, но один из самых известных. Есть и другие решения, включая бесплатные справочники ФИАС и ЕГРЮЛ. Однако самостоятельная интеграция этих справочников требует времени и поддержки. DaData берёт на себя сложность: обновление справочников, нормализацию данных, удобный API.

Для новичка использовать готовый сервис значительно проще, чем разворачивать собственный справочник. Но при росте проекта стоит оценивать затраты на API и сравнивать их с альтернативами.

Как выбрать, какие поля проверять через DaData

Не всем полям формы нужна проверка по внешним справочникам. Вот простые правила.

Проверяй через DaData, если:

• поле влияет на реальные процессы: доставка, оплата, юридические документы;
• ошибка в поле дорого обходится: недоставленный товар, отказ в платеже, недействительный договор;
• пользователи часто ошибаются: адреса, ИНН, телефоны;
• данные нужны в стандартизированном виде для интеграций.

Не проверяй через DaData, если:

• поле опционально и используется только для отображения;
• данные очевидны для пользователя: имя, комментарий, сообщение;
• стоимость запросов не окупается пользы от проверки.

Правильный баланс между обычной валидацией и DaData помогает не перегружать форму и не тратить лимиты запросов впустую.

Пример интеграции с бэкендом

Поскольку API-ключ нельзя отдавать на фронтенд, типичная схема выглядит так. Пользователь вводит адрес в браузере, браузер отправляет текст на твой бэкенд, бэкенд делает запрос в DaData с секретным ключом, получает подсказки и возвращает их пользователю. После выбора адреса фронтенд отправляет стандартизированные данные обратно на бэкенд для сохранения в базу.

Такая схема защищает ключ, позволяет кэшировать частые запросы и добавлять собственную логику. Например, бэкенд может фильтровать подсказки, оставляя только те, что относятся к регионам, с которыми работает твой магазин.

Как экономить запросы к DaData

Каждый запрос к API стоит денег или расходует лимит. Поэтому важно не слать запросы зря.

Первое правило — задержка ввода. Не запрашивай подсказки после каждого символа. Дождись, пока пользователь паузит печатание, обычно 200–300 миллисекунд достаточно.

Второе правило — минимальная длина. Смысла запрашивать подсказки по одной букве нет. Начинай с трёх-четырёх символов.

Третье правило — кэширование. Если несколько пользователей вводят одинаковые начала адресов, можно кэшировать результаты на короткое время и не ходить в API повторно.

Четвёртое правило — не проверяй всё подряд. Оценивай, какие поля реально влияют на бизнес-процессы, и проверяй только их.

Пятое правило — следи за лимитами. В личном кабинете DaData можно посмотреть статистику запросов. Если расход резко вырос, возможно, где-то утечка или пользователи делают слишком много запросов. Регулярный просмотр статистики помогает вовремя заметить аномалии и скорректировать логику запросов при необходимости и вовремя устранить причины.

Качество данных и почему оно важно

Главная ценность DaData не в красивых подсказках, а в качестве данных, которые попадают в базу. Когда адрес стандартизирован, его легко проверить, передать в службу доставки, отфильтровать по городу в отчёте. Когда ИНН проверен, можно быть уверенным, что контрагент реально существует.

Плохие данные обходятся дорого. Неправильный адрес — это недоставленный товар, возврат денег, негативный отзыв. Ошибка в ИНН — это проблемы с бухгалтерией и налоговой. Некорректный телефон — это невозможность связаться с клиентом.

Поэтому DaData стоит рассматривать как инвестицию в качество данных. Он не делает форму красивой сам по себе, но делает её надёжной. А надёжные данные экономят время и деньги на всех последующих этапах работы приложения, от обработки заказа до аналитики, отчётности и принятия взвешенных бизнес-решений на основе достоверных фактов, проверенных данных и реальных справочников.

Частые вопросы

DaData заменяет валидацию форм?

Нет, это разные уровни проверки. Обычная валидация проверяет формат данных: заполнено ли поле, правильная ли длина телефона. DaData проверяет содержание по внешним справочникам: существует ли адрес, принадлежит ли ИНН реальной организации. Использовать их нужно вместе. Подробнее про валидацию форм мы писали в отдельной статье.

Можно ли использовать DaData бесплатно?

У DaData есть ограниченный бесплатный или тестовый доступ с лимитом запросов. Для регулярного использования в приложении обычно нужен платный тариф. Точные условия и цены смотри на официальном сайте dadata.ru.

Как защитить API-ключ?

Храни ключ в переменных окружения, не коммить в git, не отдавай на фронтенд. Запросы к DaData лучше делать через свой бэкенд, который хранит ключ на сервере. В личном кабинете сервиса можно настроить ограничения по IP и следить за расходом лимитов.

Что делать, если DaData не находит адрес?

Если адрес не найден в справочнике, позволь пользователю ввести его вручную. Не блокируй отправку формы только из-за отсутствия подсказки. Некоторые адреса, особенно новые или нестандартные, могут отсутствовать в базе DaData.

Подходит ли DaData для международных адресов?

DaData специализируется на российских адресах, организациях и телефонах. Для международных адресов и иностранных компаний понадобятся другие сервисы. Перед подключением убедись, что сервис покрывает нужные тебе страны и типы данных.

Нужен ли DaData для учебного проекта?

Скорее всего, нет. Для первого приложения вроде «Змейки» обычно нет форм с адресами доставки, ИНН и телефонами. Достаточно базовой валидации форм и обычной базы данных. DaData становится полезен, когда приложение начинает работать с реальными заказами, доставкой или юридическими лицами.

Заключение

DaData — это сервис, который помогает подсказывать адреса, проверять ИНН и стандартизировать телефоны в формах. Он решает задачу, с которой не справляется обычная валидация: проверяет не формат, а содержание данных по внешним справочникам.

Для новичка DaData становится актуален тогда, когда в приложении появляются формы с адресами, реквизитами или важными контактами. На старте достаточно базовой валидации форм. Но если ты делаешь приложение с доставкой, регистрацией компаний или массовыми рассылками — DaData сильно повысит качество данных и сэкономит время пользователей.

Главное — не забывать про безопасность: API-ключ хранится в переменных окружения, запросы идут через бэкенд, а лимиты расходуются разумно. Не добавляй сервис «на всякий случай», а подключай его тогда, когда появится реальная задача. Для первых проектов сосредоточься на базовой валидации и удобном интерфейсе, а DaData оставь на тот момент, когда формы начнут работать с реальными адресами, компаниями и телефонами. Если всё сделать правильно, формы в твоём приложении станут заметно удобнее и надёжнее, а количество ошибок в адресах и контактах снизится.