Imóveis

Retorna os portais (anúncios) dos imóveis do Imoview CRM

Changed on

Retorno JSON dos portais de cada imóvel do imoview CRM: situação, tipo de destaque, datas de envio, mensagem do último envio e código do imóvel no portal.<br><br>Informe <strong>codigosimoveis</strong> e/ou <strong>codigoportal</strong> - ao menos um dos dois é obrigatório.<br><strong>codigoportal = 0</strong> significa 'meu site', que não é um vínculo de portal: ele vem nos campos <strong>exibirmeusite</strong> e <strong>tipodestaquesite</strong> do imóvel (com codigoportal = 0 o array portais volta vazio).<br>Pesquisando por <strong>codigosimoveis</strong> (máximo 200 códigos), o retorno traz os portais em qualquer situação, sem paginação, e aceita também unidades de lançamento.<br>Pesquisando somente por <strong>codigoportal</strong>, a pesquisa é paginada, considera apenas imóveis com o portal <strong>ATIVO</strong> e as unidades de lançamento só entram enviando opcaoimovel = 3.<br><br>Tokens disponíveis:<br>codigosimoveis: OPCIONAL - Enviar os códigos dos imóveis separados por vírgula (,), máximo 200 - obrigatório se codigoportal não for enviado<br>codigoportal: OPCIONAL - Enviar o código do portal (0 = meu site) - obrigatório se codigosimoveis não for enviado<br>somenteportaisativos: OPCIONAL - Enviar true para retornar somente os portais com situação ativa, caso contrário assumirá false (retorna também os retirados)<br>codigounidade: OPCIONAL - Usado na pesquisa somente por portal. Enviar código da unidade, para mais de uma unidade, separar por vírgula (,) ou vazio para todas<br>finalidade: OPCIONAL - Usado na pesquisa somente por portal. Enviar 1 para ALUGUEL, 2 para VENDA ou 0 para todas<br>situacao: OPCIONAL - Usado na pesquisa somente por portal. Enviar 0 - Todos, 1 - Vago/Disponível, 2 - Alugado, 3 - Vendido, 4 - Em reforma, 5 - Em moderação, 6 - Desativado, 7 - Em desocupação<br>opcaoimovel: OPCIONAL - Usado na pesquisa somente por portal. Enviar 1 para somente avulsos, 2 para somente lançamentos, 3 para unidades de lançamentos, 0 para avulsos e lançamentos mãe<br>numeropagina: OPCIONAL - Usado na pesquisa somente por portal (paginação), enviar o nº da página atual<br>numeroregistros: OPCIONAL - Usado na pesquisa somente por portal, nº de registros para retorno, máximo 200 (assume 20 se não enviado)

post/Imovel/RetornarPortaisImoveis

Request

  • Base URL
    https://api.imoview.com.br
  • URL
    https://api.imoview.com.br/Imovel/RetornarPortaisImoveis
  • Auth
    API key in header chave

Request body

codigosimoveisstring string
codigoportalstring string
somenteportaisativosstring string
codigounidadestring string
finalidadestring string
situacaostring string
opcaoimovelstring string
numeropaginastring string
numeroregistrosstring string

Example request

{
  "codigosimoveis": "OPCIONAL - Enviar os códigos dos imóveis separados por vírgula (,), máximo 200 - obrigatório se codigoportal não for enviado",
  "codigoportal": "OPCIONAL - Enviar o código do portal (0 = meu site) - obrigatório se codigosimoveis não for enviado",
  "somenteportaisativos": "OPCIONAL - Enviar true ou false, caso contrário assumirá false",
  "codigounidade": "OPCIONAL - Usado na pesquisa somente por portal. Enviar código da unidade, para mais de uma unidade, separar por vírgula (,) ou vazio para todas",
  "finalidade": "OPCIONAL - Usado na pesquisa somente por portal. Enviar 1 para ALUGUEL, 2 para VENDA ou 0 para todas",
  "situacao": "OPCIONAL - Usado na pesquisa somente por portal. Enviar 0 - Todos, 1 - Vago/Disponível, 2 - Alugado, 3 - Vendido, 4 - Em reforma, 5 - Em moderação, 6 - Desativado, 7 - Em desocupação",
  "opcaoimovel": "OPCIONAL - Usado na pesquisa somente por portal. Enviar 1 para somente avulsos, 2 para somente lançamentos, 3 para unidades de lançamentos, 0 para avulsos e lançamentos mãe",
  "numeropagina": "OPCIONAL - Usado na pesquisa somente por portal (paginação), enviar o nº da página atual",
  "numeroregistros": "OPCIONAL - Usado na pesquisa somente por portal, nº de registros para retorno, máximo 200 (assume 20 se não enviado)"
}

Response

Retornado com sucesso

quantidadeinteger

Example response

{
  "lista": [
    {
      "tipodestaquesite": "string",
      "portais": [
        {
          "nomeportal": "string",
          "situacao": "string",
          "tipodestaque": "string",
          "situacaoproximoenvio": "string",
          "dataprimeiroenvio": "string - formato dd/mm/yyyy hh:mm:ss ou vazio",
          "dataultimoenvio": "string - formato dd/mm/yyyy hh:mm:ss ou vazio",
          "mensagemultimoenvio": "string"
        }
      ]
    }
  ]
}

Changes

    • breaking

      the // response's property format changed from Int64 to int64 for status

    • breaking

      the // response's property format changed from Int64 to int64 for status

    • breaking

      the //// response's property format changed from Int64 to int64 for status

    • breaking

      the //// response's property format changed from Int64 to int64 for status

    • breaking

      the //// response's property format changed from Int64 to int64 for status

    • breaking

      the //// response's property format changed from Int64 to int64 for status

    • breaking

      the //// response's property format changed from Int64 to int64 for status

    • breaking

      the //// response's property format changed from Int64 to int64 for status

    • breaking

      the response's property format changed from Int64 to int64 for status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status

    • info

      added the non-success response with the status