Imóveis - POST

Este endpoint permite criar um novo imóvel, incluindo o upload de fotos, na plataforma Joviplanet.

Endpoint

POST /api/imoveis

Parâmetros do Formulário (multipart/form-data)

Todos os campos marcados com * são obrigatórios. Os principais campos são:

• imobiliariaIMOVEL* (integer): Código da imobiliária
• agenteIMOVEL* (integer): Código do agente
• clienteIMOVEL* (integer): Código do cliente
• tituloIMOVEL* (string): Título do imóvel
• descricaoIMOVEL* (string): Descrição do imóvel
• categoriaIMOVEL* (integer): Categoria do imóvel
• tipoIMOVEL* (integer): Tipo do imóvel
• planoIMOVEL* (integer): Plano do imóvel
• valorIMOVEL* (string): Valor do imóvel
• ... (demais campos obrigatórios e opcionais conforme documentação da API)
• files* (array de arquivos): Imagens do imóvel (máximo 20 arquivos)

Consulte a documentação da API para a lista completa de campos suportados.

Exemplo de Requisição (cURL)

curl -X POST "https://api.joviplanet.com/api/imoveis" \
  -H "accept: application/json" \
  -H "Authorization: Bearer <seu-token-jwt>" \
  -F "imobiliariaIMOVEL=1" \
  -F "agenteIMOVEL=1" \
  -F "clienteIMOVEL=1" \
  -F "tituloIMOVEL=Casa Exemplo" \
  -F "descricaoIMOVEL=Imóvel de exemplo para documentação." \
  -F "categoriaIMOVEL=2" \
  -F "tipoIMOVEL=1" \
  -F "planoIMOVEL=1" \
  -F "valorIMOVEL=500000" \
  -F "enderecoIMOVEL=Rua Exemplo" \
  -F "numeroIMOVEL=100" \
  -F "stateIMOVEL=SP" \
  -F "cityIMOVEL=São Paulo" \
  -F "zipcodeIMOVEL=01000-000" \
  -F "countryIMOVEL=Brasil" \
  -F "latitudeIMOVEL=-23.5505" \
  -F "longitudeIMOVEL=-46.6333" \
  -F "metragemIMOVEL=120" \
  -F "quartosIMOVEL=3" \
  -F "banheirosIMOVEL=2" \
  -F "vagasgaragemIMOVEL=2" \
  -F "files=@/caminho/para/imagem1.jpg" \
  -F "files=@/caminho/para/imagem2.jpg"

Resposta Esperada (201)

{
  "codigoIMOVEL": 0,
  "imobiliariaIMOVEL": 0,
  "agenteIMOVEL": 0,
  "clienteIMOVEL": 0,
  "tituloIMOVEL": "string",
  "descricaoIMOVEL": "string",
  "categoriaIMOVEL": 0,
  "tipoIMOVEL": 0,
  "planoIMOVEL": 0,
  "valorIMOVEL": "string",
  "labelvalorIMOVEL": "string",
  "enderecoIMOVEL": "string",
  "numeroIMOVEL": "string",
  "stateIMOVEL": "string",
  "cityIMOVEL": "string",
  "zipcodeIMOVEL": "string",
  "countryIMOVEL": "string",
  "paisIMOVEL": 0,
  "latitudeIMOVEL": "string",
  "longitudeIMOVEL": "string",
  "metragemIMOVEL": 0,
  "qtdpessoasIMOVEL": 0,
  "solteirocamasIMOVEL": 0,
  "casalcamasIMOVEL": 0,
  "banheirosIMOVEL": 0,
  "lavanderiaIMOVEL": "string",
  "wifiIMOVEL": "string",
  "closetIMOVEL": "string",
  "arcondicionadoIMOVEL": "string",
  "tipometragemIMOVEL": 0,
  "quartosIMOVEL": 0,
  "roomIMOVEL": "string",
  "vagasgaragemIMOVEL": 0,
  "fumarIMOVEL": "string",
  "salaodejogosIMOVEL": "string",
  "portariaIMOVEL": "string",
  "playgroundIMOVEL": 0,
  "proximoaometroIMOVEL": 0,
  "elevadorIMOVEL": "string",
  "poraoIMOVEL": "string",
  "quadraesportivaIMOVEL": "string",
  "festaIMOVEL": "string",
  "academiaIMOVEL": "string",
  "saunaIMOVEL": "string",
  "petsIMOVEL": "string",
  "regrasadicionaisIMOVEL": "string",
  "slugIMOVEL": "string",
  "coberturaIMOVEL": "string",
  "extraIMOVEL": "string",
  "idIMOVEL": "string",
  "comodidadesIMOVEL": {},
  "fotos": [
    {
      "imovelFOTO": 123,
      "pathFOTO": "imoveis/123/foto1.jpg",
      "padraoFOTO": 1,
      "ativoFOTO": 1
    }
  ],
  "destaqueIMOVEL": 0,
  "criancasIMOVEL": 0,
  "checkinIMOVEL": "string",
  "checkoutIMOVEL": "string",
  "permanenciaminimaIMOVEL": 0,
  "permanenciamaximaIMOVEL": 0,
  "fotosIMOVEL": "string",
  "videoIMOVEL": "string",
  "360IMOVEL": "string",
  "emailIMOVEL": "string",
  "disponivelIMOVEL": 0,
  "quadrabasqueteIMOVEL": 0,
  "sotaoIMOVEL": 0,
  "porteiroIMOVEL": 0,
  "jardimdefrenteIMOVEL": 0,
  "vistadolagoIMOVEL": 0,
  "vistadomarIMOVEL": 0,
  "espacoprivadoIMOVEL": 0,
  "adegaIMOVEL": 0,
  "sprinklersIMOVEL": 0,
  "floorIMOVEL": 0,
  "visualizacaoIMOVEL": 0,
  "cliquesIMOVEL": 0,
  "datacriacaoIMOVEL": "2025-05-30T16:02:56.638Z",
  "ativoIMOVEL": 0
}

Resposta de Erro (400)

• Erro na criação do imóvel

Observação: O header Authorization deve conter seu token JWT válido, obtido via autenticação.