Erros, limites e LGPD

Erros

Erros vêm sempre em JSON, com o código HTTP coerente:

{ "mensagem": "Credencial inválida." }

Situação	HTTP
Credencial ausente, inválida ou revogada	401
Imóvel inexistente ou não anunciado (/imoveis/{id})	404
Parâmetro inválido	400
Limite de requisições excedido	429
Falha temporária	500

Em caso de 500, tente de novo mais tarde. Não trate uma resposta de erro como "nenhum imóvel": interrompa a sincronização e mantenha a cópia atual.

Limites

• 120 requisições por minuto por credencial. Acima disso a API responde 429 com o header Retry-After (em segundos).
• Até 200 imóveis por página.
• Uma varredura completa da carteira (cerca de 1.500 imóveis) leva 8 requisições com por_pagina=200.

Versionamento

Mudanças incompatíveis (remover ou renomear campo, mudar tipo ou significado) só entram numa nova versão (/api/v2), com aviso prévio. Campos novos podem ser acrescentados na v1: ignore os campos que você não conhece.

Dados pessoais (LGPD)

A API não envia:

• nome, documento, telefone ou e-mail de proprietário, inquilino ou corretor
• contratos e dados financeiros internos
• localização ou identificação de chaves
• observações internas da equipe
• número e complemento do endereço

Os campos são uma lista fechada no servidor. O que não está em Campos e valores não sai da API.