Morphos

Морфология для Вашего сайта.

Использоавани REST API

Вы можете использовать следующие методы REST API:

Склонение имён

GET /api/inflect-name

Параметры:

  1. обязательное name - имя человека в формате "Фамилия Имя" или "Фамилия Имя Отчество".
  2. gender - пол владельца имени. Может принимать одно из значений: m или f. Если поле отсутствует, пол будет определён автоматически и добавлен в ответ.

Склоняет имя и возвращает все падежи.

Структура ответа:

  • name - дубликат имени после нормализации
  • cases - массив склонённых форм имени в стандартной последовательности (Им. п, Род. п, Дат. п, Вин. п, Тв. п, Пред. п)
  • gender - поле присутствует только если в запросе не был указан пол. Содержит определённыый автоматически пол по имени.

Пример запроса и ответа:

GET /api/inflect-name?name=Иванов+Иван&_format=json
{
    "name": "Иванов Иван",
    "cases": [
        "Иванов Иван",
        "Иванова Ивана",
        "Иванову Ивану",
        "Иванова Ивана",
        "Ивановым Иваном",
        "об Иванове Иване"
    ],
    "gender": "m"
}

Склонение названий городов/стран

GET /api/inflect-geographical-name

Параметры:

  1. обязательное name - название города или страны.

Склоняет имя и возвращает все падежи.

Структура ответа:

  • name - дубликат названия после нормализации
  • cases - массив склонённых форм имени в стандартной последовательности (Им. п, Род. п, Дат. п, Вин. п, Тв. п, Пред. п)

Пример запроса и ответа:

GET /api/inflect-geographical-name?name=москва&_format=json
{
    "name": "москва",
    "cases": [
      "Москва",
      "Москвы",
      "Москве",
      "Москву",
      "Москвой",
      "о Москве"
    ],
}

Формат ответа

Формат ответа (json или xml) может быть изменён с помощью параметра _format.