Documentação da API REST

Faça login como corretor ou imobiliária para visualizar o seu ID de integração.

Endpoints Disponíveis

1. Consulta de Imóveis

GET /components/com_imobiliaria/api/v1/{{idcorretor:idimobiliaria}}/imoveis

Parâmetros (Query String): nome, uf, cidade, tipo_contrato, tipo_imovel, valor_min, valor_max, tamanho_min, tamanho_max, banheiros, quartos, suites, vagas, ordenacao, limit, page

fetch('https://www.alugarcasas.com.br/components/com_imobiliaria/api/v1/{{idcorretor:idimobiliaria}}/imoveis?cidade=São Paulo&limit=10')
  .then(response => response.json())
  .then(data => console.log(data));
2. Detalhe do Imóvel

GET /components/com_imobiliaria/api/v1/{{idcorretor:idimobiliaria}}/imoveis/{id}

fetch('https://www.alugarcasas.com.br/components/com_imobiliaria/api/v1/{{idcorretor:idimobiliaria}}/imoveis/123')
  .then(response => response.json())
  .then(data => console.log(data));
3. Consulta de Cidades

GET /components/com_imobiliaria/api/v1/{{idcorretor:idimobiliaria}}/cidades

fetch('https://www.alugarcasas.com.br/components/com_imobiliaria/api/v1/{{idcorretor:idimobiliaria}}/cidades')
  .then(response => response.json())
  .then(data => console.log(data));
4. Tipos de Contrato

GET /components/com_imobiliaria/api/v1/{{idcorretor:idimobiliaria}}/tipoContratos

5. Tipos de Imóveis

GET /components/com_imobiliaria/api/v1/{{idcorretor:idimobiliaria}}/tipoImoveis

6. Envio de Proposta

POST /components/com_imobiliaria/api/v1/{{idcorretor:idimobiliaria}}/propostas

// JavaScript (Fetch API)
const payload = {
  id_imovel: 123,
  nome: 'João da Silva',
  email: '[email protected]',
  telefone: '11999999999',
  valor_proposta: 500000
};

fetch('https://www.alugarcasas.com.br/components/com_imobiliaria/api/v1/{{idcorretor:idimobiliaria}}/propostas', {
  method: 'POST',
  headers: { 'Content-Type': 'application/json' },
  body: JSON.stringify(payload)
})
.then(response => response.json())
.then(data => console.log(data));
7. Envio de Mensagens

POST /components/com_imobiliaria/api/v1/{{idcorretor:idimobiliaria}}/mensagens

Exemplo PHP (cURL)
<?php
$url = "https://www.alugarcasas.com.br/components/com_imobiliaria/api/v1/{{idcorretor:idimobiliaria}}/imoveis";
$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$response = curl_exec($ch);
curl_close($ch);
$data = json_decode($response, true);
print_r($data);
?>
Exemplo Java (HttpClient)
HttpClient client = HttpClient.newHttpClient();
HttpRequest request = HttpRequest.newBuilder()
      .uri(URI.create("https://www.alugarcasas.com.br/components/com_imobiliaria/api/v1/{{idcorretor:idimobiliaria}}/imoveis"))
      .build();
HttpResponse<String> response = client.send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());