Vitrines compartilhadas

Quando um corretor envia uma seleção de imóveis por link, o site abre essa vitrine com o contato dele.

No sistema e no app, o corretor escolhe imóveis e gera um link curto para mandar ao cliente (por exemplo, seusite.com.br/v/Ab12Cd34). O site usa o código do link para buscar a vitrine nesta rota.

GET/vitrines/{codigo}

Os imóveis que um corretor escolheu compartilhar num link, mais o contato dele.

#Parâmetros no caminho

Parâmetro	Tipo	Descrição
`codigo`	string	Código do link, de 4 a 32 letras e números.

#Exemplo

cURL

curl "https://web.zariv.com.br/api/public/v1/vitrines/Ab12Cd34" \
  -H "Authorization: Bearer $ZARIV_API_KEY"

JavaScript

const resposta = await fetch("https://web.zariv.com.br/api/public/v1/vitrines/Ab12Cd34", {
  headers: { Authorization: `Bearer ${process.env.ZARIV_API_KEY}` },
});
const dados = await resposta.json();
console.log(dados);

Python

import os, requests

resposta = requests.get(
    "https://web.zariv.com.br/api/public/v1/vitrines/Ab12Cd34",
    headers={"Authorization": f"Bearer {os.environ['ZARIV_API_KEY']}"},
    timeout=15,
)
print(resposta.json())

PHP

<?php
$ch = curl_init("https://web.zariv.com.br/api/public/v1/vitrines/Ab12Cd34");
curl_setopt_array($ch, [
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => ["Authorization: Bearer " . getenv("ZARIV_API_KEY")],
]);
$dados = json_decode(curl_exec($ch), true);
curl_close($ch);

#Resposta

200 OK

{
  "vitrine": {
    "codigo": "Ab12Cd34",
    "corretor": {
      "nome": "Maria Souza",
      "creci": "1234-F/RO",
      "telefone": "69999990000"
    },
    "imoveis": [
      {
        "id": "3f2b6c1e-5a1d-4b7e-9d0a-6a8f1c2e7b10",
        "codigo": "AP-102",
        "slug": "apartamento-3-quartos-centro-cacoal",
        "titulo": "Apartamento de 3 quartos no Centro",
        "situacao": "disponivel",
        "descricao": "Apartamento amplo, com sacada e vista livre.",
        "tipo_imovel": "apartamento",
        "finalidade": "venda",
        "valor_venda": 420000,
        "valor_condominio": 480,
        "aceita_financiamento": true,
        "aceita_permuta": false,
        "aceita_fgts": true,
        "bairro": "Centro",
        "cidade": "Cacoal",
        "estado": "RO",
        "area_util": 92,
        "quartos": 3,
        "suites": 1,
        "banheiros": 2,
        "vagas_garagem": 1,
        "tags_caracteristicas": [
          "Sacada",
          "Elevador",
          "Portaria 24h"
        ],
        "fotos": [
          {
            "url": "https://exemplo.zariv.com.br/fotos/ap-102-1.jpg",
            "principal": true
          }
        ],
        "destaque_site": true,
        "corretor": {
          "nome": "Maria Souza",
          "creci": "1234-F",
          "telefone": "69999990000"
        }
      }
    ]
  }
}

Testar agoraUsa a sua chave de API e consulta os seus dados de verdade. A chave não é guardada nem enviada para a Zariv além desta chamada.

Chave de API codigo (no caminho)

#Como a vitrine se comporta

Os imóveis vêm na ordem em que o corretor escolheu.
O contato exibido é sempre o de quem compartilhou (campo vitrine.corretor), e não o corretor cadastrado em cada imóvel.
Imóveis que saíram do ar depois do compartilhamento simplesmente deixam de aparecer.
Links desativados ou expirados respondem 404.
Cada abertura é contada nas estatísticas do corretor (visualizações do link).