Consolas en la nube de ESET, interfaces de programación de aplicaciones (API)
Para entender cómo afectan los cambios a su integración, es importante distinguir entre las categorías de gateway e interfaz de programación de aplicaciones (API) a las que sirve.
ESET Connect (pasarela)
ESET Connect es una pasarela alojada en la nube gestionada íntegramente por ESET. Actúa como punto de entrada entre el cliente y los servicios de backend de los siguientes servicios en la nube ESET:
Categorías de la API ESET Connect
La gateway proporciona acceso a conjuntos específicos de APIs, que están organizadas en Categorías.
Versiones |
Cada categoría de API tiene su propio ciclo de vida independiente de versión. Esta es la versión que especificas en el enlace de tu código (por ejemplo, /v1/groups). |
Impacto |
Las actualizaciones de las Categorías de API de ESET Connect pueden cambiar las llamadas a la API. |
Política de fin de ciclo de vida |
Política de cambios de ruptura
ESET puede realizar cambios sin previo aviso si el cambio se considera no incumplido.
|
ESET hará esfuerzos razonables para notificarte con antelación de cambios que no se noten con suficiente tiempo para adaptarte a ellos. |
Un cambio de ruptura es un cambio en las interfaces de programación de aplicaciones (APIs) que puede requerir modificaciones en una aplicación para evitar interrupciones en su integración o requerir cambios para mantener la compatibilidad.
A continuación, algunos ejemplos de cambios que consideramos cambios de ruptura:
•formato de respuesta modificado,
•campo renombrado,
•campo eliminado,
•cambio de tipo de datos,
•cambio de código de error,
•cambio en la lógica empresarial.
Los cambios de ruptura también pueden ser causados por cambios relacionados con la autenticación, el alcance de permisos, los límites de velocidad, cambios de transporte/URL y otros factores.
Un cambio no de ruptura es un cambio al que puede adaptarte a su propia discreción y ritmo, sin interrupciones.
A continuación, algunos ejemplos de cambios que consideramos que no son cambios de ruptura:
•nuevo campo añadido,
•nuevo parámetro opcional añadido,
•nuevo valor añadido,
•aumento del límite de tarifa,
•soporte para más formatos, etc.
Periodo de transición
Durante el periodo de transición, dado que el periodo de tiempo en el que una versión anterior de una Categoría API permanece disponible tras la introducción de la nueva versión de la Categoría API o el reemplazo funcional, la versión anterior seguirá estando disponible durante un periodo definido y limitado de Soporte Limitado. ESET hará esfuerzos razonables para garantizar la compatibilidad y proporcionar a los clientes tiempo suficiente para adaptarse a estos cambios.
El Soporte Limitado de la versión de Categorías de la API ESET Connect comienza en la fecha anunciada, normalmente en la fecha de anuncio público para los clientes finales. La versión de Categorías de la API ESET Connect pasará al Soporte Limitado y estará disponible durante todo el periodo hasta su fecha de fin de vida. Tras el Soporte Limitado, la versión de Categorías de la API ESET Connect dejará de estar disponible.
Reglas de versiones
Cambios de ruptura |
Cualquier versión que contenga un cambio de ruptura estará claramente marcada en la documentación. |
Cambios no de ruptura |
Si una versión contiene solo cambios ininterrumpidos, la versión de la Categoría API permanece igual. Los detalles se pueden encontrar en la documentación de ayuda de ESET Connect. |