Compartir a través de

Cambios importantes: API de AST

  • Artículo

Nuestra API de AST está cambiando continuamente. La gran mayoría de los cambios simplemente agregan nueva funcionalidad, pero en ocasiones presentamos cambios importantes que pueden requerir que ajuste la integración.

En esta página se explican los cambios que califican como cambios importantes en nuestra API de AST. También proporciona ejemplos de cambios que no califican como cambios importantes.

Nota:

Xandr se reserva el derecho de corregir errores, ajustar la funcionalidad para cumplir con parte de nuestras directivas de servicio y obligaciones legales, y cambiar las características y los productos en alfa y beta sin previo aviso.

Cambios importantes

Los siguientes tipos de cambios califican como cambios importantes:

  • Eliminación o cambio del nombre de un campo en una respuesta del controlador de eventos (api adObj)
  • Eliminación del objeto de una definición de función de devolución de llamada del controlador de eventos
  • Eliminación o cambio del nombre de un método AST (por ejemplo, defineTag() o showTag())
  • Modificación del tipo de datos de un campo (por ejemplo, una matriz de identificadores convertidos en una matriz de objetos)

Nota:

Al introducir un cambio importante en nuestra API de AST, admitiremos la versión de AST sin el cambio importante como versión de producción (/ast.js) durante 45 días. Durante este período de 45 días, la nueva versión (que incluye cambios importantes) estará disponible en una dirección URL estática (/v1.0.1/ast.js). Después de los 45 días, la versión de cambio importante se promoverá a la dirección URL de producción. Todas las versiones recientes de AST estarán disponibles a través de la dirección URL estática, por lo que puede seguir usando la versión sin el cambio importante llamando a su versión específica en su lugar.

Además, notificaremos a los usuarios de AST estos cambios y cómo llegar correctamente a cada versión durante el período de cambios importantes.

Los cambios importantes en el protocolo AST se anunciarán en nuestra página Historial de versiones de AST . Le recomendamos que se suscriba a las actualizaciones para recibir notificaciones proactivas de cambios importantes. (Para los clientes Xandr, los cambios importantes también se anunciarán en las notas de la versión).

Ejemplos de cambios no importantes

Los siguientes tipos de cambios no califican como cambios importantes. Tenga en cuenta que esta lista no es exhaustiva; estos son solo algunos ejemplos de cambios no importantes.

  • Adición de un nuevo campo no obligatorio
  • Adición de un nuevo método AST
  • Desuso de un campo sin quitarlo
  • Cambie en el orden de los campos de un objeto, los objetos de una matriz, etc.