Ambiente e moderação

📘

Resumo

A API pública tem um único ambiente (produção), mas incluir imóveis por API é seguro para testes: tudo nasce em moderação e nada é publicado sem uma ação humana.

🌐 Um ambiente só: produção

A API pública tem um único ambiente (produção), na base URL:

https://api.imoviewnext.com.br/pub/v1

Não há um ambiente separado de sandbox. Mas isso não significa que você não pode testar com segurança: é aí que entra a moderação.

🗺️ Ciclo de vida do imóvel

flowchart TD
  A["POST /properties"] --> B["em_moderacao<br/>(não aparece em portal)"]
  B --> C{"Convênio revisa<br/>no produto"}
  C -->|"libera para publicação"| D["Publicado no feed do portal"]
  C -->|"PATCH /status"| E["alugado / vendido /<br/>em_reforma / ..."]

🛡️ Moderação protege quem testa

Todo imóvel criado por API nasce em em_moderacao e não entra em feed de portal até que alguém do convênio libere, dentro do produto. Ou seja: você pode incluir imóveis de teste à vontade que nada é publicado sem uma ação humana.

Para "publicar" de fato, é preciso ativar a situação depois (PATCH /properties/{id}/status), e mesmo esse PATCH não aceita vago_disponivel: o único estado publicável só é atingido por gente, dentro do sistema.

👍

Na prática

Incluir imóvel por API é seguro para testes. O que você criar fica em moderação, visível só internamente, até o convênio decidir.

🎯 Leads, pessoas e atendimento

🚧

Estes vão para dados reais

Diferente de imóveis, leads, pessoas e as ações do atendimento caem no fluxo real do convênio. Combine antes ou use dados reconhecíveis.

• Leads de teste entram na fila de atendimento: combine com o convênio para não poluir o atendimento real, ou use um external_id reconhecível.
• Pessoas de teste ficam no cadastro: prefira dados claramente fictícios e, se precisar, remova depois pelo produto.
• Ações no atendimento (anotar, descartar, agendar visita, registrar parecer, incluir proposta, atividades) valem na hora: a imobiliária vê o resultado imediatamente e os webhooks disparam. Teste num atendimento combinado com o convênio.

🧹 Limpeza

Não há endpoint público de exclusão de cadastro. Registros de teste são removidos/ajustados dentro do sistema, pelo convênio. Pela API, dá para descartar o atendimento e cancelar visita e atividade.