1. Imóveis
Veploy API
  • Visão geral
  • Autenticação
  • Limites de requisição
  • Imóveis
    • Listar imóveis
      GET
    • Consultar imóvel
      GET
    • Cadastrar imóvel
      POST
    • Alterar imóvel
      PATCH
    • Excluir imóvel
      DELETE
    • Restaurar imóvel
      POST
    • Enviar foto do imóvel (Beta)
      POST
    • Remover foto do imóvel (Beta)
      DELETE
    • Listar tipos de imóvel
      GET
  • Proprietários
    • Listar proprietários
    • Consultar proprietário
    • Cadastrar proprietário
    • Alterar proprietário
    • Excluir proprietário
  • Leads
    • Listar leads
    • Consultar lead
    • Criar lead
    • Alterar responsável
    • Atualizar lead
    • Consultar linha do tempo do lead
  • Visitas
    • Listar visitas
    • Consultar visita
    • Agendar visita
    • Alterar visita
  • Propostas
    • Listar propostas
    • Consultar proposta
    • Registrar proposta
    • Alterar proposta
  • Portais
    • Listar portais
    • Consultar portal
    • Listar imóveis do XML
  • Usuários
    • Listar usuários
    • Consultar usuário
    • Consultar permissões do usuário
    • Convidar usuário
    • Alterar ficha do usuário
    • Desativar usuário
    • Reativar usuário
    • Remover usuário
  • Perfis de acesso
    • Listar perfis de acesso
  • Artigos
    • Listar artigos
    • Criar artigo
    • Consultar artigo
    • Alterar artigo
    • Enviar capa do artigo (Beta)
  • Temas
    • Tema do site
  1. Imóveis

Enviar foto do imóvel (Beta)

POST
/v1/properties/{ref}/images
Beta: o contrato pode receber ajustes.
Envia uma foto e já a anexa ao imóvel, no fim da lista ou em position. Uma foto por chamada, corpo multipart/form-data com a parte file e, opcionalmente, alt e position. Para um imóvel com muitas fotos, cadastre o imóvel sem foto e envie as fotos em paralelo, até 6 por vez por conta: cada uma entra na chegada, sem id para guardar nem segunda chamada. A ordem final pode ser ajustada depois em PATCH /v1/properties/{ref} (media.images), que também troca a capa.
A foto é validada pelo conteúdo (JPEG, PNG ou WebP), otimizada (JPEG, sem metadados, até 1600 pixels no lado maior) e gravada no CDN da conta. Equivale a POST /v1/media com purpose=property seguido do vínculo. Dispara property.updated.
Respostas
201: foto anexada; data é a foto como aparece em media.images[].
400: arquivo ausente, tipo não aceito, foto fora das dimensões ou campo inválido.
404 PROPERTY_NOT_FOUND: inexistente, na lixeira, de outra conta ou fora do recorte da chave.
413 FILE_TOO_LARGE: arquivo acima de 15 MB.
429 UPLOAD_CONCURRENCY_EXCEEDED: a conta já tem 6 uploads em andamento; nada foi lido. Reenvie após o Retry-After.
503: o armazenamento ou o otimizador de imagem não respondeu, ou há uploads demais em andamento na plataforma (UPLOAD_BUSY); nada foi gravado. Retry-After diz quando tentar de novo.
Não aceita Idempotency-Key: reenviar o mesmo arquivo anexa outra foto.

Requisição

Authorization
Bearer Token
Forneça seu token bearer no cabeçalho
Authorization
ao fazer requisições para recursos protegidos.
Exemplo:
Authorization: Bearer ********************
or
Parâmetros de Caminho

Parâmetros Bodymultipart/form-dataNecessário

Respostas

🟢201
application/json
Default Response
Bodyapplication/json

🟠400
🟠401
🟠403
🟠404
🟠413
🟠429
🔴500
🔴503
Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://api.veploy.com/v1/properties//images' \
--header 'Authorization: Bearer <token>' \
--form 'file=@""' \
--form 'alt=""' \
--form 'position=""'
Response Response Example
201 - Exemplo 1
{
    "data": {
        "id": "string",
        "url": "string",
        "featured": true,
        "alt": null,
        "position": 0
    }
}
Modificado em 2026-11-12 20:21:28
Página anterior
Restaurar imóvel
Próxima página
Remover foto do imóvel (Beta)
Built with