Como saber quais anúncios estão online?
Após executar operações diferentes com relação aos anúncios, é desejável saber se elas foram aplicadas corretamente, e para obter informações dos anúncios on-line, pode-se utilizar o endpoint
GET /v1/imobiliarias/{codigoImobiliaria}/anuncios/online/resumo
Que fornece uma lista de anúncios on-line para uma determinada imobiliária. O usuário tem a possibilidade de obter todos os anúncios on-line ou filtrá-los por alguma característica de seu interesse, e assim realizar a pesquisa mais personalizada.
Requisição
Com relação aos filtros, eles podem ser aplicados juntos ou simplesmente com um filtro de cada vez. Lembre-se de que, ao aplicar vários filtros ao mesmo tempo, os anúncios devem estar em conformidade com cada um deles. Alguns dos filtros permitem enviar mais de um valor para pesquisar, nesses casos, o anúncio pode corresponder a um único valor.
Os filtros que podem ser aplicados são os seguintes:
- idAvisoNavplat: Esse ID é interno à equipe do Open Navent. Pode ser obtido logo após a publicação do anúncio. Você pode pesquisar apenas com um idAvisoNavplat.
- codigoAviso: Este código é compartilhado entre ambas as partes para a identificação de um anúncio. Somente um codigoAviso pode ser enviado.
- idUbicacion: ID do local a pesquisar. Você pode enviar IDs diferentes, os valores separados por "," da forma valor[, valor].
- titulo: Você pode enviar o título de um anúncio ou palavras/texto para pesquisar nos títulos.
- operacion: Tipo de operação. Você pode obtê-los com o endpoint /v1/operacoes. Somente uma operação pode ser enviada.
- idTipoDePropiedad: ID tipo da propriedade. Ids diferentes podem ser enviados, os valores separados por "," da forma valor[, valor].
- precioDesde: Preço mínimo para a pesquisa.
- precioHasta: Preço máximo para a pesquisa.
- codigoMoneda: Insira o ID da moeda que pode ser obtido em /v1/moedas
Informação
O idAvisoNavplat é predominante, ou seja, no caso de o codigoAviso ser enviado, em conjunto com o idAvisoNavplat, será levado em conta o idAvisoNavplat somente. Em seguida, os filtros podem ser combinados da maneira que o integrador deseja.
Resposta
Em relação à resposta do endpoint, é uma lista de anúncios, com algumas informações sobre eles. A estrutura da resposta é a seguinte:
“claveInterna”: “string”,
“codigoAviso”: “string”,
“codigoDesarrollo”: “string”,
“fechaModificacion”: “2019-11-28T13:04:21.210Z”,
“fechaModificado”: “string”,
“idAvisoNavplat”: 0,
“idDesarrolloNavplat”: 0,
“imagen”: {
“titulo”: “string”,
“urlImagenOriginal”: “string”,
“urlImagenPortal”: “string”
},
“publicacion”: “string”,
“tipoDeAviso”: “string”,
“tipoDePropiedad”: 0,
“titulo”: “string”,
“ubicacion”: {
“codigoPostal”: “string”,
“direccion”: “string”,
“idUbicacion”: “string”,
“latitud”: “string”,
“longitud”: “string”,
“muestraMapa”: “string”,
“ubicacion”: “string”
}
}]
Melhoria
Um novo endpoint foi adicionado, trazendo um resumo de todos os lançamentos e suas unidades
GET /v1/imobiliarias/{codigoImobiliaria}/lancamentos/online/resumo
Informação
A informação mostrada no campo de imagem é sobre a imagem principal do anúncio.
ATENÇÃO
Os filtros são todos aplicados ao mesmo tempo, ou seja, um aviso deve estar em conformidade com todos eles para que seja obtido. Se algum dos filtros estiver errado e/ou inválido, a pesquisa retornará um erro ou todos os anúncios da imobiliária.