Pesquisar imóveis [API]

Este artigo descreve o serviço da API responsável pela pesquisa de imóveis. Este serviço geralmente é consumido pelo site do cliente.

Segurança

Para acessar o serviço de pesquisa, a aplicação deve enviar um token de acesso fornecido pelo administradora da organização.

Para acessar o serviço de pesquisa o sistema deve fazer uma requisição do tipo "POST” no “EndPoint” definido pela “URL Org” da organização

Verbo	POST
Url org	Endereço fornecido pelo administrador. Exemplo: https://snapproperty-developer-edition.na132.force.com
Serviço	/services/apexrest/snap_brok/imovel/pesquisar
Endpoint	https://snapproperty-developer-edition.na132.force.com/services/apexrest/snap_brok/imovel/pesquisar

Os parâmetros utilizados para pesquisa estão descritos na tabela abaixo.

Parâmetro	Tipo	Descrição	Exemplo
Offset	Número	Utilizado na paginação de registros para definir a posição inicial do primeiro imóvel a ser retornado.	0
RegistrosPagina	Número	Utilizado na paginação de registros para definir a quantidade de imóveis que devem ser retornados.	25
Filtros	Array[String]	Lista de filtros que devem ser considerados na pesquisa de imóveis. Cada filtro deve ser composto por: Operador lógico (ex.: AND) Campo (ex.: snap_brok__Disponivel_locacao__c) Operador para comparação (ex.: = ) Valor (ex.: TRUE)	[ “AND snap_brok__Disponivel_locacao__c = TRUE”, “snap_brok__area_privativa__c >= 100” ]
Ordenacao	String	Define a regra para ordenação dos imóveis encontrados.	snap_brok__Valor_locacao_total__c DESC

Na tabela abaixo estão descritos os campos retornados pelo serviço quando a pesquisa é realizada com sucesso.

Campo	Tipo	Descrição	Exemplo
Total	Número	Indica a quantidade total de imóveis encontrados com os filtros aplicados.	90
Mensagem	String	Mensagem do sistema	"Pesquisa realizada com sucesso"
Imoveis	Array[Imovel]	Array com os registros dos imóveis retornados pela pesquisa.	[ { "attributes": { "type": "snap_brok__Imovel__c", "url": "/services/data/v51.0/sobjects/snap_brok__Imovel__c/a050B00000fnHxDQAU" }, "Id": "a050B00000fnHxDQAU", "Name": "Rua T-38 0 Apto 2001", "snap_brok__area_privativa__c": 158.51, "snap_brok__Banheiros__c": 2, "snap_brok__Complemento__c": "Apto 2001", "snap_brok__codigo__c": "I-001299", "snap_brok__Disponivel_venda__c": false, "snap_brok__Dormitorios__c": 2, … } ]
Erro	Boolean	FALSE

Campo	Tipo	Descrição	Exemplo
Total	Número		null
Mensagem	String	Mensagem de erro gerada pelo serviço	"Erro na pesquisa de imóveis: Erro na pesquisa de imóveis: unexpected token: '100' - linha: 493 na linha 502"
Imoveis	Array[Imovel]		null
Erro	Boolean	TRUE