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

Дополняет ФИО по началу ввода, раскладывает на фамилию/имя/отчество и определяет пол. Два режима: целая строка ("query": "иванова мари") или дополнение одной части через parts. С флагом declensions к каждой подсказке добавляются склонения по шести падежам. Доступен по публичному ключу (pk_…) — подходит для браузерных форм.

Параметры запроса

Поля ответа

POST /v1/suggest/fio
{ "query": "иванова мари", "count": 5 }

// фильтр по полу + склонения по 6 падежам:
{ "query": "иванова мария сергеевна", "gender": "FEMALE", "declensions": true }

// дополнение одной части (фамилия / имя / отчество):
{ "query": "ал", "parts": ["NAME"], "gender": "MALE" }

Подсказки email

Достраивает адрес по началу ввода: к локальной части подставляет распространённые почтовые домены (gmail.com, yandex.ru, mail.ru и др.). Доступен по публичному ключу (pk_…).

Параметры запроса

Поля ответа

POST /v1/suggest/email
{ "query": "ivan@gma", "count": 3 }

Стандартизация ФИО

Разбирает ФИО на части, определяет пол и исправляет регистр. Пакетно — через items (нативный ответ) или массивом строк (плоский DaData-формат). Для автодополнения при вводе используйте подсказки ФИО с разбором на части и склонениями по падежам.

POST /v1/clean/fio
{ "source": "иванова мария сергеевна" }

Поля ответа

Проверка телефона

Нормализует номера РФ и зарубежных стран: определяет страну, тип (мобильный/городской) и валидность. Для РФ дополнительно — оператор (с учётом переноса номера), регион и часовой пояс.

Формат вывода задаётся полем mask в теле запроса. Допустимые значения: имя пресета из списка ниже ("mask": "intl") или пользовательский шаблон ("mask": "+7 (XXX) XXX-XX-XX"), где плейсхолдер цифры — X, # или 9; остальные символы сохраняются без изменений. Маска накладывается на национальный номер любой страны:

• e164 → +79627302371
• intl → +7 (962) 730-23-71
• national → 8 (962) 730-23-71
• intl_sp → +7 962 730-23-71
• dash → +7-962-730-23-71
• spaces → 8 962 730 23 71
• plain → 9627302371
• plain8 → 89627302371
• свой шаблон, напр. +7 (XXX) XXX-XX-XX

POST /v1/clean/phone

// mask — ИМЯ пресета (intl / e164 / national …) ИЛИ свой шаблон "+7 (XXX) XXX-XX-XX"
{ "items": ["89627302371", "+375 29 491-19-11"],
  "mask": "intl" }

Поля ответа

Проверка email

Проверяет синтаксис и доменную зону, возвращает признак доставляемости и тип адреса.

POST /v1/clean/email
{ "source": "maria@hintdata.ru" }

// пакетно — массив строк (ответ в плоском DaData-формате):
["maria@hintdata.ru", "info@bad..ru"]

Поля ответа

Стандартизация даты рождения

Приводит дату из любого формата («4 фев 1985», «04.02.1985», «1985-02-04») к единому формату и рассчитывает возраст.

POST /v1/clean/birthdate
{ "source": "04 февраля 1985 г." }

// любой формат → ДД.ММ.ГГГГ + возраст
{
  "domain": "birthdate",
  "results": [{
    "source": "04 февраля 1985 г.",
    "birthdate": "04.02.1985",
    "year": 1985,
    "month": 2,
    "day": 4,
    "age": 41,
    "is_adult": true,
    "qc": 0
  }]
}

Поля ответа