Документация API

OpenKyrgyz предоставляет бесплатный REST API для спряжения глаголов и склонения существительных. Все эндпоинты доступны для чтения и не требуют авторизации.

Скачать OpenAPI спецификацию (openapi.yaml)

GET /api/v1/verbs/conjugations/{verb}

Возвращает спряжения глагола. По умолчанию включает все 10 времён × 4 формы × 8 местоимений, повелительные, оптатив и залоги.

Параметр	Обязательный	По умолчанию	Описание
`verb`	В пути	—	Основа глагола на кыргызской кириллице (например бар, кел, жаз)
`tenses`	Нет	все	Список времён через запятую. Значения: PresentAndFuture, PresentContinuous, FutureProbable, FutureGoingTo, PastDefinite, PastIndefinite, PastUsedTo, PastSudden, Conditional, Intention, Imperative, Optative
`forms`	Нет	все	Список форм через запятую. Значения: Positive, Negative, Interrogative, NegativeAndInterrogative
`includeMoods`	Нет	`true`	Включить пассивный/возвратный/совместный залог
`includeVerbForms`	Нет	`false`	Включить формы глагола: деепричастие, причастие, причина, цель и др.
`includeTimeForms`	Нет	`false`	Включить временные формы: когда, пока, до, после и др.

# All conjugations
curl "https://open-kyrgyz.kg/api/v1/verbs/conjugations/бар"

# Only past tenses + imperatives
curl "https://open-kyrgyz.kg/api/v1/verbs/conjugations/бар?tenses=PastDefinite,Imperative"

# Negative form only, with verb forms
curl "https://open-kyrgyz.kg/api/v1/verbs/conjugations/бар?forms=Negative&includeVerbForms=true"

GET /api/v1/nouns/declensions/{noun}

Возвращает склонение существительного. По умолчанию включает падежи и притяжательные формы.

Параметр	Обязательный	По умолчанию	Описание
`noun`	В пути	—	Существительное на кыргызской кириллице (например үй, бала, китеп)
`includeCases`	Нет	`true`	Включить склонение по 6 падежам в ед. и мн. числе
`includePossessive`	Нет	`true`	Включить притяжательные формы с полным склонением для 7 местоимений
`includeCopula`	Нет	`false`	Включить связочные формы для 8 местоимений

# Cases and possessive (default)
curl "https://open-kyrgyz.kg/api/v1/nouns/declensions/үй"

# Cases only
curl "https://open-kyrgyz.kg/api/v1/nouns/declensions/үй?includePossessive=false"

# With copula forms
curl "https://open-kyrgyz.kg/api/v1/nouns/declensions/үй?includeCopula=true"