Property Sync API

Challenge

The idea emerged while maintaining the Special Imóveis website. Manually updating listings between a source system and WordPress leaves room for stale ads, duplicates and rework. The challenge was not just to import an API, but to make synchronization repeatable without side effects.

Details

• The solution separates concerns into small components: paginated API reads, data normalization, change detection, WordPress persistence, concurrency control and operational logging. The result is a flow that is readable, testable and straightforward to maintain.
• Each listing keeps its external ID and receives a SHA-256 fingerprint of normalized content. The plugin creates new records, updates only what changed and skips what is already correct. One invalid listing does not stop the batch, and a lock prevents concurrent syncs.
• The admin interface configures the connection, runs a manual sync and explains what happened through counters and logs. Tokens stay masked; the same routine can be scheduled with WP-Cron, with request limits, stale-lock recovery and controlled log retention.