ФИО в анкете: подсказки, раскладка по полям и пол

Где это нужно

• Оформление заказа и доставки — имя получателя без опечаток.
• Анкета клиента в банке, страховой, МФО: ФИО сверяется с документами, ошибка стоит отказа.
• Регистрация в сервисе, где к человеку потом обращаются по имени и отчеству.

Как подключить

Полю ФИО ставим data-hintdata="fio". Если в базе фамилия, имя и отчество хранятся отдельно, разложите выбранный вариант атрибутами data-fill-surname, data-fill-name и data-fill-patronymic. Пол удобно положить в скрытое поле.

<script src="https://api.hintdata.ru/widget.js" data-key="pk_ваш_ключ"></script>

<label for="fio">Фамилия, имя, отчество</label>
<input id="fio" data-hintdata="fio"
  data-fill-surname="#surname" data-fill-name="#name"
  data-fill-patronymic="#patronymic" data-fill-gender="#gender">

<label for="surname">Фамилия</label>
<input id="surname">
<label for="name">Имя</label>
<input id="name">
<label for="patronymic">Отчество</label>
<input id="patronymic">
<input id="gender" type="hidden">

Что приходит в ответе

Тонкости

• Подсказка не заменяет человека: незнакомую или редкую фамилию можно ввести целиком, форма её примет.
• Пол определяется по имени и отчеству. Если по введённому этого не понять — например, только фамилия на -ко, — поле останется пустым.
• Порядок не важен: «Марина Иванова» и «Иванова Марина» разложатся одинаково.

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

Это проверка, что человек ввёл настоящее имя?

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

Можно ли привести уже накопленную базу ФИО в порядок?

Да, для этого есть стандартизация: она разбирает строку на фамилию, имя и отчество, исправляет регистр и определяет пол. Описание — в документации.

Сколько это стоит?

Подсказки по ФИО входят в дневной лимит тарифа, на бесплатном — до 10 000 запросов в день.