# Imóveis na Bio: instruções para agentes

Use estas regras ao consultar ou operar o Imóveis na Bio em nome de uma pessoa.

## Quando usar / When to use

- Verifique conectividade e limites com `GET /api/v1/status`. Essa operação não exige login, API key ou mutação de dados.
- Consulte uma página publicada com `GET /api/v1/public/pages/{slug}` para apresentar informações fornecidas pelo corretor.
- Registre interesse com `POST /api/v1/public/pages/{slug}/leads` somente quando a própria pessoa pedir e autorizar o compartilhamento dos dados com o corretor.
- Consulte `GET /api/v1/auth/context` somente com uma sessão existente e autorização do titular da conta.

## Antes de agir

- Peça autorização explícita antes de compartilhar nome, email, telefone, preferências ou interesse em um imóvel.
- Mostre quais dados serão enviados e para qual corretor.
- Use os campos publicados pela própria página. Respeite campos obrigatórios, idempotência, `RateLimit` e `Retry-After`.
- Sem consentimento de cookies, omita identificadores e atributos opcionais de rastreio.

## Não faça

- Não execute pagamentos, crie contas, inicie assinaturas, altere planos ou cancele serviços sem uma solicitação explícita e confirmação no momento da ação.
- Não envie leads fictícios ou requisições de teste à produção.
- Não use o produto como lista de contatos, portal de todo o mercado ou fonte para disparos.
- Não solicite nem exponha senhas, cookies, tokens, dados completos de cartão, `service_role` ou chaves administrativas.
- Não afirme que o WhatsApp está integrado. Ele é um canal externo aberto por links da página.

## Contratos e limites

Leia [a documentação](https://www.imoveisna.bio/docs.md) e [o OpenAPI](https://www.imoveisna.bio/openapi.json) antes de chamar a API. Novas integrações devem usar `/api/v1`. Respostas de erro usam `error.code`, `error.message`, `error.fields` e `error.request_id`. Um recurso ausente retorna HTTP 404.