Documentación · Modelo de datos

Política de cambios

Nuestro modelo de datos, nuestros archivos y nuestra API cambiarán a medida que agreguemos fuentes y campos. Esta página explica qué anunciamos, dónde lo hacemos y cómo crear una integración que siga funcionando cuando haya cambios.

Por qué hay cambios

La mayoría de los cambios agregan algo: una fuente nueva, una propiedad nueva cuando podemos procesarla, un formato de archivo nuevo. Otros eliminan o renombran elementos: una fuente que deja de publicarse, una propiedad reemplazada por una mejor, un punto de acceso rediseñado. Las eliminaciones y los cambios de nombre son los que pueden romper una integración, por lo que esta política se centra en ellos.

Qué cubre el registro de cambios

El registro de cambios documenta los cambios en el modelo de datos, los archivos de metadatos, los formatos de descarga y la API, así como la eliminación de fuentes. Las fuentes nuevas no se anuncian allí una por una; aparecen en Todas las fuentes de datos y en sources.json de cada colección.

Aviso previo a eliminaciones y cambios de nombre

Componente	Adiciones	Eliminaciones y cambios de nombre
Modelo de datos (esquemas, propiedades, temas)	Sin aviso previo	Por confirmar
Archivos de metadatos (`index.json`, `sources.json`, catálogo)	Sin aviso previo	Por confirmar
Fuentes y colecciones	Sin aviso previo	Por confirmar (una fuente también puede desaparecer cuando su editor deja de publicarla o retira el permiso)
API	Sin aviso previo	Por confirmar
Formatos de descarga y columnas	Sin aviso previo	Por confirmar

Por proporcionar: el plazo de aviso para cada eliminación o cambio de nombre indicado arriba, y si difiere para los clientes con contrato. Son compromisos con los clientes y requieren la decisión de un responsable, en coherencia con la sección 11 de los términos.

Cómo crear una integración duradera

Ignore lo que no conoce. Lea los campos y las propiedades que necesita y omita el resto, de modo que las propiedades nuevas, los campos nuevos en index.json y las colecciones nuevas no afecten su código.
No dependa de una lista fija de fuentes. Trate datasets y sources.json como listas abiertas.
Verifique la versión. Compare el version de cada colección en el catálogo antes de descargar, y verifique los archivos con sus sumas de comprobación SHA-256.
Almacene los ID de los registros, no los nombres. Consulte cómo almacenar referencias.
Lea el registro de cambios antes de actualizar cualquier componente que procese nuestros archivos.

Para seguir los cambios en un lector de feeds, suscríbase al feed RSS del registro de cambios (/estate/changelog/rss.xml). Contiene las mismas entradas que la página del registro de cambios.

Preguntas y comentarios

Escriba a [email protected] si un cambio le afecta, o consulte Obtener soporte.

Por proporcionar: si habilitaremos un canal comunitario (foro o chat) para integradores.

Última actualización: 2026-10-04