↑ API стандартизации
Код проверки
API стандартизации ФИО
✔️ Исправляет опечатки и транслитерирует.
✔️ Проставляет пол.
✔️ Склоняет по падежам (кого? кому? кем?).
Как вызвать
Чтобы вызвать метод, зарегистрируйтесь и подтвердите почту.
Пример запроса:
curl -X POST \
-H "Content-Type: application/json" \
-H "Authorization: Token ${API_KEY}" \
-H "X-Secret: ${SECRET_KEY}" \
-d '[ "Срегей владимерович иванов" ]' \
https://dadata.ru/api/v2/clean/name
Укажите при вызове:
Content-Type: application/json.${API_KEY}— API-ключ.${SECRET_KEY}— секретный ключ.
Тело запроса передавайте в кодировке UTF-8.
Что в ответе
Стандартизованные объекты:
[
{
"source": "Срегей владимерович иванов",
"result": "Иванов Сергей Владимирович",
"result_genitive": "Иванова Сергея Владимировича",
"result_dative": "Иванову Сергею Владимировичу",
"result_ablative": "Ивановым Сергеем Владимировичем",
"surname": "Иванов",
"name": "Сергей",
"patronymic": "Владимирович",
"gender": "М",
"qc": 1
}
]
| Название | Длина | Описание |
|---|---|---|
| source | 100 | Исходное ФИО одной строкой |
| result | 150 | Стандартизованное ФИО одной строкой |
| result_genitive | 150 | ФИО в родительном падеже (кого?) |
| result_dative | 150 | ФИО в дательном падеже (кому?) |
| result_ablative | 150 | ФИО в творительном падеже (кем?) |
| surname | 50 | Фамилия |
| name | 50 | Имя |
| patronymic | 50 | Отчество |
| gender | 10 |
Пол
М — мужской Ж — женский НД — не удалось однозначно определить |
| qc | 5 | Код проверки |
Код проверки qc
Требуется ли вручную проверить распознанное значение:
| Код qc | Описание | Нужно проверить вручную? |
|---|---|---|
| 0 | Исходное значение распознано уверенно | нет |
| 2 | Исходное значение пустое или заведомо «мусорное» | нет |
| 1 | Исходное значение распознано с допущениями или не распознано | да |
Коды ответа на запрос
| HTTP-код ответа | Описание |
|---|---|
| 200 | Запрос успешно обработан |
| 400 | Некорректный запрос |
| 401 | В запросе отсутствует API-ключ или секретный ключ Или в запросе указан несуществующий ключ |
| 403 | Не подтверждена почта Или недостаточно средств для обработки запроса, пополните баланс |
| 405 | Запрос сделан с методом, отличным от POST |
| 413 | Запрос содержит более 10 записей |
| 429 | Слишком много запросов в секунду |
| 5xx | Произошла внутренняя ошибка сервиса |
Ограничения
В запросе может быть до 10 записей.
Максимальная частота запросов:
- 10 запросов/сек, если в запросе 1 запись;
- 5 запросов/сек, если в запросе 2 записи;
- 2 запроса/сек, если в запросе 5 записей;
- 1 запрос/сек, если в запросе 10 записей.
Дадата не поддерживает вызов стандартизации из JavaScript. Иначе злоумышленник мог бы похитить секретный ключ и использовать стандартизацию за ваш счет.
Стоимость
5–10 копеек за запись, скидки за объём.
