Перейти к содержимому
POST AI agent ready /v1/semver/compare

Semver Compare API — бесплатное сравнение версий

Сравните две строки семвера (например, «1.2.3» и «1.3.0») и получите результат: -1 (a < b), 0 (равно) или 1 (a > b). Обрабатывает идентификаторы предварительной версии согласно спецификации semver 2.0.0.

Parameters

stringrequired

First semantic version.

stringrequired

Second semantic version.

Code examples

curl -X POST https://api.botoi.com/v1/semver/compare \
  -H "Content-Type: application/json" \
  -d '{"version_a":"2.1.0","version_b":"2.3.1"}'

When to use this API

Проверки обновлений зависимостей

Сравните установленную версию пакета с последней доступной версией, чтобы определить, требуется ли обновление.

Функция ворот с флагом

Сравните версию пользовательского приложения с минимальной версией, чтобы решить, включать ли новую функцию или отображать запрос на обновление.

Frequently asked questions

Правильно ли обрабатываются предварительные версии?
Да. Идентификаторы предварительной версии, такие как 1.0.0-alpha.1, сравниваются в соответствии со спецификацией semver 2.0.0, где предварительные версии имеют более низкий приоритет, чем версия.
Учитываются ли метаданные сборки при сравнении?
Нет. Метаданные сборки (например, +build.123) игнорируются во время сравнения согласно спецификации semver.
Что означает значение результата?
-1 означает, что a меньше, чем b, 0 означает, что они равны, а 1 означает, что a больше, чем b.
Могу ли я сравнить диапазоны версий, например «^1.2.0»?
Нет. Эта конечная точка сравнивает две точные строки версий. Сопоставление диапазонов не поддерживается.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.