Imóveis no site
Quais imóveis a API entrega ao site, o que muda conforme a situação e o que nunca sai do sistema.
A imobiliária cadastra os imóveis na Zariv, e a API pública entrega ao site apenas o que pode ser exibido. Quem integra precisa saber quais imóveis aparecem, quando e com que dados.
#Situação do imóvel e a API
| Situação | Aparece na busca do site? | Abre por link direto? |
|---|---|---|
| Disponível | Sim | Sim |
| Em negociação | Sim | Sim |
| Vendido / Alugado | Só se o site pedir com situacao=vendido ou alugado | Sim, para links antigos continuarem funcionando |
| Reservado, inativo ou rascunho | Não | Não |
| Arquivado | Não | Não |
#O que a imobiliária controla
- Destaque: imóveis marcados como destaque vêm primeiro na busca e podem ser filtrados com
destaque=true. - Número do endereço: quando a imobiliária oculta o número,
logradouro,numeroecomplementonão vêm na resposta. - Fotos: a ordem e a foto principal são definidas no sistema, e a API entrega já nessa ordem.
- Corretor responsável: aparece no imóvel, a menos que o cadastro esteja sem corretor definido.
#O que nunca sai pela API
Dados do proprietário, comissão, exclusividade, matrícula e cartório, observações internas e chaves do imóvel ficam só no sistema. A lista de campos da resposta é fechada: veja O objeto imóvel.
#Atualizações
Quando a imobiliária altera um imóvel (valor, fotos, situação), a próxima chamada à API já traz a mudança. Se o seu site guarda respostas em cache, a alteração aparece quando o cache vence. Veja os tempos sugeridos em Limites e erros.