Вы можете использовать следующие методы REST API:
GET /api/inflect-name
Параметры:
name
- имя человека в формате "Имя", "Фамилия Имя" или "Фамилия Имя Отчество".gender
- пол владельца имени. Может принимать одно из значений: m
или f
. Если поле отсутствует, пол будет определён автоматически и добавлен в ответ.Склоняет имя и возвращает все падежи.
Структура ответа:
name
- дубликат имени после нормализацииcases
- массив склонённых форм имени в стандартной последовательности (Им. п, Род. п, Дат. п, Вин. п, Тв. п, Пред. п)gender
- поле присутствует только если в запросе не был указан пол. Содержит определённыый автоматически пол по имени. Если пол определить не удалось, будет возвращено значение unknown.Пример запроса и ответа:
GET /api/inflect-name?name=Иванов+Иван&_format=json
{ "name": "Иванов Иван", "cases": [ "Иванов Иван", "Иванова Ивана", "Иванову Ивану", "Иванова Ивана", "Ивановым Иваном", "об Иванове Иване" ], "gender": "m" }
GET /api/inflect-geographical-name
Параметры:
name
- название города или страны.Склоняет имя и возвращает все падежи.
Структура ответа:
name
- дубликат названия после нормализацииcases
- массив склонённых форм имени в стандартной последовательности (Им. п, Род. п, Дат. п, Вин. п, Тв. п, Пред. п)Пример запроса и ответа:
GET /api/inflect-geographical-name?name=москва&_format=json
{ "name": "москва", "cases": [ "Москва", "Москвы", "Москве", "Москву", "Москвой", "о Москве" ], }
Формат ответа (json или xml) может быть изменён с помощью параметра _format
.