Property Sync API

Desafio

A ideia nasceu durante a manutenção do site da Special Imóveis. Atualizar imóveis manualmente entre um sistema de origem e o WordPress abre espaço para anúncios desatualizados, duplicidade e retrabalho. O desafio não era apenas importar uma API: era garantir que a sincronização pudesse rodar de novo sem criar efeitos colaterais.

Detalhes

• A solução separa as responsabilidades em componentes pequenos: leitura paginada da API, normalização dos dados, detecção de mudanças, persistência no WordPress, controle de concorrência e registro da operação. Isso torna o fluxo legível, testável e simples de manter.
• Cada imóvel mantém seu ID externo e recebe uma assinatura SHA-256 do conteúdo normalizado. Com isso, o plugin cria registros novos, atualiza apenas o que mudou e ignora o que já está correto. Um imóvel inválido não interrompe o lote, e um lock impede duas sincronizações ao mesmo tempo.
• A interface administrativa permite configurar a conexão, disparar uma sincronização manual e entender o que aconteceu por meio de contadores e logs. Tokens permanecem mascarados; a mesma rotina pode ser agendada pelo WP-Cron, com limites de requisição, recuperação de lock expirado e retenção controlada de logs.