Documentação API - LeoCash

Use nossa API para integrar imóveis e leads com o sistema LeoCash.

Autenticação

Todas as requisições devem incluir um token Bearer no header Authorization:

Authorization: Bearer seu-token-api

Tokens podem ser gerados no painel da Construtora em "Tokens API".

Imóveis/api/external/properties

POST/api/external/properties

Criar ou atualizar um imóvel.

Body (JSON):

{
  "reference": "IMV-001",
  "title": "Apartamento Centro",
  "description": "Lindo apartamento...",
  "type": "APARTAMENTO",
  "purpose": "SALE",
  "salePrice": 350000,
  "city": "São Paulo",
  "state": "SP",
  "street": "Rua Exemplo",
  "number": "123",
  "district": "Centro",
  "zipcode": "01001-000",
  "roomMin": 2,
  "bathroomMin": 1,
  "garageMin": 1,
  "areaTotalMin": 65,
  "acceptsFGTS": true,
  "acceptsFinancing": true,
  "principalMedia": "https://..."
}

Resposta (201):

{
  "property": {
    "id": "clx...",
    "reference": "IMV-001",
    "title": "Apartamento Centro",
    ...
  }
}

GET/api/external/properties?page=1&limit=50

Listar seus imóveis cadastrados.

Query Params:

page - Página (padrão: 1)
limit - Itens por página (padrão: 50)

Leads / Clientes/api/external/leads

POST/api/external/leads

Enviar um lead/cliente para o sistema.

Body (JSON):

{
  "name": "João Silva",
  "email": "joao@email.com",
  "phone": "(11) 99999-9999",
  "cityOfInterest": "São Paulo",
  "stateOfInterest": "SP"
}

Resposta (201):

{
  "user": {
    "id": "clx...",
    "email": "joao@email.com"
  },
  "created": true
}

Tipos de Imóvel (Enum)

CASAAPARTAMENTOTERRENOCOMERCIALLOJASALAGALPAOIMOVEL_RURALOUTROS