Política de versiones de la API
/api/v2 es estable. En ella no se quitan campos, no cambia el significado de un campo y no se hace obligatorio un parámetro que era opcional.
Sí se pueden añadir campos, parámetros opcionales y endpoints nuevos. Tu integración debe ignorar los campos que no conozca.
Cómo se retira algo
Cualquier retirada se anuncia en las release notes con al menos 6 meses de antelación. El aviso dice qué se retira, desde cuándo y qué usar en su lugar. Durante ese plazo el endpoint responderá con las cabeceras Deprecation y Sunset (RFC 8594).
Cambios incompatibles
Los cambios que rompen la compatibilidad van a /api/v3. /api/v2 sigue disponible al menos 12 meses después de que salga /api/v3.
Instancias dedicadas y on-premise
Las instancias dedicadas y on-premise reciben cada cambio cuando se actualizan, nunca antes.
Retiradas anunciadas
| Endpoint | Usar en su lugar | Anunciado | Se retira |
|---|---|---|---|
GET /api/v2/instance/details/{seqFrom} | GET /api/v2/instance/mapping/{seqFrom} | 1.9.4 | 23 de abril de 2027 |
Última actualización
API de Mapeo de Instancia
La API de mapeo de instancia devuelve IDs y descripciones de clientes, instalaciones, dispositivos y endpoints, hasta 500 registros por llamada.
Herramientas Low-Code (Scripting)
Qué son los scripts de la plataforma: código JavaScript para procesar datos de dispositivos, ejecutar acciones complejas y crear dispositivos propios.