Comece em 5 minutos

⚡

Objetivo

O caminho mais curto do zero à primeira chamada bem-sucedida.

1️⃣ Gere uma chave de API

No sistema, vá em Configurações > Chaves de API e crie uma chave. Na aba Permissões, marque só os escopos que a integração vai usar (ex.: leads:write para enviar leads). A chave não muda de escopo depois de criada: se precisar de outro conjunto, crie outra e revogue a antiga.

🚧

O valor aparece uma única vez

A chave é exibida apenas no momento da criação. Copie e guarde num lugar seguro. Se perder, gire a chave (não crie outra), para manter o histórico de uso.

2️⃣ Faça sua primeira chamada

O catálogo é o melhor ponto de partida (funciona com qualquer escopo de imóvel) e prova que a sua chave está válida:

curl https://api.imoviewnext.com.br/pub/v1/schema/property-types \
  -H "Authorization: Bearer imn_seuconvenio_..."

👍

Deu certo?

Se você recebeu uma lista de tipos de imóvel, a sua chave está válida e você já está integrado.

3️⃣ Escolha seu fluxo

📘

Antes de escrever

Antes de escrever imóveis ou pessoas, leia Conceitos-chave: tudo vai por nome (não por id) e o catálogo é a fonte da verdade.