Saltar al contenido principal
Version: v1.0.0

Registro de cambios

Historial de cambios al contrato de integración.

Versionado​

Usamos versionado semántico:

  • MAJOR (X.0.0): cambio incompatible con versiones anteriores (ej: campo obligatorio nuevo, cambio de nombre o formato de un campo).
  • MINOR (0.X.0): nuevo campo opcional, nueva regla de validación no bloqueante, nuevo endpoint.
  • PATCH (0.0.X): corrección de documentación, ajuste de umbrales, mejora de mensajes.

Versión actual​

v1.0.0 — Contrato inicial de integración.

Política de cambios​

  • Campos deprecados: se marcan como tales en Esquema de propiedad y se mantienen funcionando por al menos 90 días.
  • Reglas de validación nuevas (BLOCK): se anuncian con al menos 30 días de anticipación para que pueda ajustar sus datos.
  • Cambios de endpoint (URL o método HTTP): aviso con al menos 90 días de anticipación.

Los cambios se documentan en este changelog. Los cambios mayores (MAJOR) se comunican con anticipación.

v1.0.0 (2026-06-30)​

Primera versión pública del contrato de integración.

Documentos incluidos:

  • Property Schema: definición del JSON de propiedades.
  • Pull Protocol: contrato del endpoint GET.
  • Feedback Webhook: contrato del webhook POST.
  • Lifecycle: estados de una propiedad en el tiempo.
  • Deletion Protocol: eliminación explícita y reconciliación.
  • Security: autenticación, HMAC, TLS.
  • QA Rules: catálogo de reglas de validación.
  • Error Catalog: códigos de error.
  • Examples: casos de uso concretos.
  • Quickstart: guía de integración.

Schema de propiedad:

  • 6 campos obligatorios: external_id, property_type, city, state, rent_price|sale_price, updated_at.
  • 7 valores canónicos de property_type.
  • 2 monedas soportadas: MXN, USD.
  • 3 modalidades: rent, sale, rent_and_sale.
  • 19 amenidades con matching por palabra clave.
  • Campos específicos por tipo: industrial, oficina, local, terreno.

Validaciones:

  • 19 reglas BLOCK.
  • 7 reglas DRAFT.
  • 1 regla WARN.

Webhook:

  • 2 eventos: item_accepted, item_rejected.
  • HMAC-SHA256 para verificación de autenticidad.
  • Deduplicación vía request_id.
  • Mensajes en español (configurable a inglés).