[
{
"major": "2",
"minor": "1",
"patch": "0",
"pre_release": "beta.3",
"build": "build.9"
}
]
curl --location --request POST 'https://zylalabs.com/api/13846/semantic+version+toolkit+api/31837/parse+version+string' --header 'Authorization: Bearer YOUR_API_KEY' --header 'Content-Type: application/json' --data-raw '{}'
[
{
"value": 300
}
]
curl --location --request POST 'https://zylalabs.com/api/13846/semantic+version+toolkit+api/31839/check+version+satisfies+range' --header 'Authorization: Bearer YOUR_API_KEY' --header 'Content-Type: application/json' --data-raw '{}'
[
{
"value": 300
}
]
curl --location --request POST 'https://zylalabs.com/api/13846/semantic+version+toolkit+api/31840/bump+version+according+to+release+type' --header 'Authorization: Bearer YOUR_API_KEY' --header 'Content-Type: application/json' --data-raw '{}'
Después de registrarte, a cada desarrollador se le asigna una clave de acceso a la API personal, una combinación única de letras y dígitos proporcionada para acceder a nuestro endpoint de la API. Para autenticarte con el Herramienta de Versionado Semántico API simplemente incluye tu token de portador en el encabezado de Autorización.
| Encabezado | Descripción |
|---|---|
Autorización
|
Requerido
Debería ser Bearer access_key. Consulta "Tu Clave de Acceso a la API" arriba cuando estés suscrito.
|
Sin compromiso a largo plazo. Mejora, reduce o cancela en cualquier momento. La Prueba Gratuita incluye hasta 50 solicitudes.
(Ahorra 2 meses pagando anualmente 🎉)
Cada endpoint devuelve datos JSON estructurados El endpoint "analizar cadena de versión" devuelve componentes de una versión incluyendo mayor menor parche pre-lanzamiento y construcción El endpoint "comprobar si la versión satisface el rango" devuelve un valor booleano que indica si la versión cumple con el rango especificado El endpoint "aumentar versión según tipo de lanzamiento" devuelve la nueva cadena de versión aumentada
Los campos clave en la respuesta para el endpoint "analizar cadena de versión" incluyen "mayor", "menor", "parche", "pre_lanzamiento" y "compilación" Para los endpoints "verificar si la versión satisface el rango" y "aumentar versión" el campo clave es "valor" que indica el resultado de la operación
Los datos de respuesta están organizados como un arreglo de objetos JSON Cada objeto contiene pares clave-valor que representan los componentes de la versión o el resultado de la operación Por ejemplo la respuesta de "analizar cadena de versión" incluye componentes de versión individuales mientras que los otros puntos finales devuelven un único valor que indica éxito o la nueva versión
El endpoint "analizar cadena de versión" requiere una cadena de versión con el formato 'MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]'. El endpoint "verificar si la versión satisface el rango" requiere una cadena de versión y un rango con el formato '>=1.0.0 <2.0.0'. El endpoint "aumentar versión según el tipo de lanzamiento" requiere una cadena de versión actual y un tipo de lanzamiento especificado (mayor, menor o parche)
Los casos de uso típicos incluyen validar cadenas de versión para cumplir con la Versionado Semántico garantizar que las dependencias de software cumplan con los requisitos de versión y automatizar las actualizaciones de versión en proyectos de software Los desarrolladores pueden usar estas funcionalidades para mantener la compatibilidad y agilizar la gestión de versiones
Los usuarios pueden utilizar los datos devueltos al analizar la respuesta JSON para extraer los componentes de versión o resultados relevantes Por ejemplo después de analizar una cadena de versión los desarrolladores pueden acceder programáticamente a los valores mayor menor y parche para un procesamiento o validación adicional en sus flujos de trabajo de desarrollo
Los patrones de datos estándar incluyen cadenas de versión formateadas como 'MAYOR.MENOR.PATCH' con metadatos de pre-lanzamiento y de compilación opcionales Las respuestas seguirán consistentemente la estructura JSON con campos específicos como "mayor" "menor" y "valor" claramente definidos permitiendo un manejo de datos predecible en las aplicaciones
La precisión de los datos se mantiene al adherirse a la especificación de Versionado Semántico 2.0.0 garantizando que las cadenas de versión se analicen y validen correctamente El diseño determinista de la API garantiza resultados consistentes para las mismas entradas mejorando la fiabilidad en las tareas de gestión de versiones
La respuesta del punto final de la cadena de versión de análisis incluye campos clave: "mayor", "menor", "parche", "pre_lanzamiento" y "construcción". Cada campo corresponde a un componente de la cadena de versión semántica, lo que permite a los desarrolladores acceder y utilizar fácilmente información específica de la versión para cumplimiento y validación
La versión de comprobación satisface el punto final de rango que proporciona información sobre si una cadena de versión específica cumple con los criterios de un rango de versión dado La respuesta indica un valor booleano ayudando a los desarrolladores a asegurarse de que sus dependencias de software se alineen con las restricciones de versión requeridas
Los datos de respuesta para el endpoint de versión bump están organizados como un objeto JSON que contiene un único campo "value" que representa la nueva cadena de versión bump. Esta estructura permite a los desarrolladores recuperar rápidamente la versión actualizada después de especificar la versión actual y el tipo de lanzamiento
El extremo de la cadena de versión de análisis acepta un solo parámetro: la cadena de versión formateada como 'MAJOR.MINOR.PATCH[-PRERELEASE][+BUILD]' Los usuarios deben asegurarse de que la cadena de versión cumpla con la especificación de Versionado Semántico 2.0.0 para un análisis y respuesta precisos
Los usuarios pueden utilizar los datos devueltos accediendo a los componentes individuales de la cadena de versión, como los números mayor, menor y de corrección. Esta información se puede usar para la validación de versiones, la gestión de dependencias o para informar notas de lanzamiento y documentación en flujos de trabajo de desarrollo de software
Los casos de uso típicos para el endpoint de versión de incremento incluyen la automatización de actualizaciones de versión en proyectos de software, asegurando el cumplimiento de las prácticas de versionado semántico y gestionando los incrementos de versión en función de los cambios realizados como correcciones de errores (parche), nuevas características (menor) o cambios incompatibles (mayor)
La respuesta del endpoint de versión de verificación indica si la cadena de versión proporcionada cumple con los criterios de rango especificados Un valor de 300 en la respuesta significa que la versión satisface el rango mientras que un valor diferente indicaría falta de cumplimiento ayudando a mantener la compatibilidad del software
La precisión de los datos en la API del Toolkit de Versiones Semánticas se mantiene a través de una estricta adherencia a la especificación de Versionado Semántico 2.0.0 La API procesa cadenas de versiones de manera consistente y determinista garantizando salidas confiables sin retener los cuerpos de las solicitudes lo que mejora la integridad de las operaciones de versionado