Подсказки: ФИО

Подсказывает ФИО одной строкой или по компонентам.

Что умеет

✔️ Подсказывает ФИО одной строкой или отдельно фамилию, имя, отчество.

✔️ Исправляет клавиатурную раскладку («fynjy» → «Антон»).

✔️ Определяет пол.

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

Вставьте код из примера на свой сайт.
Profit!

<input id="fullname" name="fullname" type="text" />
<link href="https://cdn.jsdelivr.net/npm/@dadata/suggestions@25.4.1/dist/suggestions.min.css" rel="stylesheet" />
<script src="https://cdn.jsdelivr.net/npm/@dadata/suggestions@25.4.1/dist/suggestions.min.js"></script>

<script>
    const input = document.getElementById("fullname");
    Dadata.createSuggestions(input, {
        token: "${API_KEY}",
        type: "name"
    });
</script>

Параметр token — это API-ключ.

Демонстрация

Выберите вариант из списка, чтобы увидеть полный текст ответа в JSON:

ФИО

Также работает через API

Что в ответе

Аргумент suggestion функции onSelect выглядит так:

Название	Описание
value	ФИО одной строкой
unrestricted_value	= value
data.surname	Фамилия
data.name	Имя
data.patronymic	Отчество
data.gender	Пол MALE — мужской FEMALE — женский UNKNOWN — не удалось однозначно определить
data.qc	Код проверки 0 — все части ФИО известны 1 — в ФИО есть неизвестная часть
Не используется
data.source

Источники данных: собственные справочники имен, фамилий и отчеств.

Примеры настройки

Подсказывать часть ФИО:

Подсказывать ФИО отдельными полями

Только женские ФИО

Ограничения

На бесплатном тарифе плагин подсказок показывает логотип «Дадаты» в углу выпадающего списка. На платных тарифах и в «коробке» логотипа нет.

Количество запросов в день — в соответствии с тарифным планом.

Длина запроса — не более 300 символов.

Количество условий (параметр locations) — не более 10.

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

Подсказки не работают: ошибка 403 Forbidden (Feature SUGGESTIONS disabled for token)

Возможные причины:

В запросе указан неправильный API-ключ. Проверьте в личном кабинете
Исчерпан лимит запросов на день. Проверьте в личном кабинете
Не подтверждён адрес эл. почты. Проверьте в личном кабинете

Что будет, если превысить 10 000 бесплатных запросов в день?

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

10 000 запросов считаются суммарно по всем видам подсказок: адреса, ФИО, организации, банки, емейлы...

Стоимость

Бесплатно до 10 тысяч запросов в день. Больше — в составе годовой подписки.