Sincronização

O modelo recomendado tem duas etapas:

1. Carga inicial, uma vez: varredura completa de /imoveis.
2. Incremental, periodicamente (por exemplo, a cada 30 minutos): /imoveis?alterados_desde=… traz só o que mudou.

Paginação por cursor

A listagem é paginada por cursor, em ordem estável por id. Cada resposta traz:

{
  "dados": [ { "id": "…", "codigo": "AP0042", "publicado": true } ],
  "por_pagina": 200,
  "proximo_cursor": "0b6c1f2e-3a4d-4e5f-8a9b-0c1d2e3f4a5b",
  "total": 1526
}

• Para a próxima página, envie o valor recebido em cursor.
• proximo_cursor: null significa fim. Uma página intermediária nunca vem vazia.
• total é o total do filtro inteiro, não da página. Use-o para conferir a varredura.
• por_pagina vai de 1 a 200. O padrão é 50.

Por que cursor e não número de página: se um imóvel é publicado ou retirado durante a varredura, a paginação por número desloca os registros e pode pular ou repetir imóveis. Com o cursor, isso não acontece.

# 1ª página
curl -H "Authorization: Bearer SEU_TOKEN" \
  "https://admin.independenceimoveis.com.br/api/v1/imoveis?por_pagina=200"

# próximas: use o proximo_cursor da resposta anterior
curl -H "Authorization: Bearer SEU_TOKEN" \
  "https://admin.independenceimoveis.com.br/api/v1/imoveis?por_pagina=200&cursor=0b6c1f2e-3a4d-4e5f-8a9b-0c1d2e3f4a5b"

Carga inicial (varredura completa)

Sem alterados_desde, a listagem devolve só os imóveis anunciados. Depois da varredura completa, um imóvel que está na sua cópia e não apareceu saiu do ar.

Guarde o horário em que a varredura começou: ele é o ponto de partida do primeiro incremental.

Incremental

curl -H "Authorization: Bearer SEU_TOKEN" \
  "https://admin.independenceimoveis.com.br/api/v1/imoveis?alterados_desde=2026-10-15T14:30:00-03:00"

Devolve tudo o que foi criado ou alterado desde o instante, inclusive os imóveis que deixaram de ser anunciados. Esses vêm assim, para que você os retire do portal:

{ "id": "…", "codigo": "AP0042", "publicado": false, "atualizado_em": "2026-10-15T18:02:11.104+00:00" }

• atualizado_em muda com qualquer alteração relevante: preço, status, publicação, fotos, características, endereço, título ou descrição.
• Guarde o horário de início de cada consulta e use-o como alterados_desde da seguinte, com 1 a 2 minutos de margem para trás.
• O incremental também é paginado por cursor, como a varredura completa.
• Data em ISO 8601 com fuso. Use Z ou -03:00. Um + na URL vira espaço se não for codificado como %2B.

Exclusões

Despublicar ou inativar não é exclusão: esses imóveis aparecem no incremental com publicado: false. Exclusão física do cadastro é rara e aparece em:

curl -H "Authorization: Bearer SEU_TOKEN" \
  "https://admin.independenceimoveis.com.br/api/v1/imoveis/removidos?desde=2026-10-01T00:00:00-03:00"

{ "dados": [ { "id": "…", "codigo": "AP0042", "removido_em": "2026-10-10T15:52:20.022+00:00" } ] }

Resumo do ciclo

primeira vez:  varredura completa (cursor até null) → guarda T0 = início
a cada 30 min: incremental alterados_desde = T(anterior) − 2 min
                 publicado: true  → insere/atualiza
                 publicado: false → retira do portal
               removidos?desde = T(anterior) − 2 min → retira do portal
               guarda T = início desta consulta
1× por dia (opcional): varredura completa para reconciliar a cópia