Tentar de novo a ingestão dos assets
POST /property-v1/properties/{paId}/assets
No caminho normal você não chama isto. As fotos e a planta viajam dentro do objeto quando você cadastra o imóvel, e nós as baixamos sozinhos. Este endpoint existe para tentar de novo quando alguma não pôde ser baixada.
Por que baixamos as suas imagens
Porque se o anúncio viajar com a URL do seu CDN, o portal acaba servindo conteúdo que não controlamos. Ao baixá-las e servi-las nós, o anúncio deixa de depender de o seu CDN continuar no ar e servindo a mesma coisa.
Quando chamá-lo
Quando o bloco images de qualquer resposta disser que algo falhou. Esse bloco vem em todas as
respostas do imóvel —cadastro, atualização, baixa e leitura— justamente para que você não tenha que
perguntar à parte:
status | O que significa | Tentar de novo? |
|---|---|---|
processing | estamos baixando | não: espere e leia o imóvel de novo |
ready | todas prontas e servidas por nós | não |
partial | algumas sim, outras não | sim, e o detalhe de quais está nesse mesmo bloco |
failed | não foi possível | sim |
Como se pede
curl -X POST https://property-api.mapaprop.com/property-v1/properties/01M4.../assets \
-H "Authorization: Bearer $TOKEN" \
-H "x-client-ref: cliente-42"
Sem body: as URLs já estão no imóvel, então não há nada para mandar. O que ele faz é tentar de novo o que ficou pendente.
É idempotente e determinístico. Tentar de novo sobrescreve o que já tinha sido baixado com o mesmo resultado, então chamá-lo duas vezes não duplica nada nem muda as URLs. Se você quiser trocar uma imagem, isso é atualizar o imóvel, não tentar de novo.
O que é aceito
| Formatos | |
|---|---|
| Fotos | JPEG · PNG · WebP |
| Planta | JPEG · PNG · WebP · PDF |
Um arquivo vazio, de um tipo que não está nessa lista ou que supera o limite de tamanho não é
tentado de novo sozinho: o bloco images diz qual e por quê, e isso se corrige trocando o arquivo
do seu lado.
Códigos de resposta
| Código | O que aconteceu |
|---|---|
200 | a nova tentativa rodou; olhe o bloco images para ver como ficou |
400 | falta identificar o cliente, ou o paId não é válido |
401 · 403 | token ausente, inválido ou sem permissão de escrita |
404 | não há um imóvel com esse paId para esse cliente |
409 | estão sendo baixadas agora mesmo. Não é um erro seu: espere e leia o imóvel de novo |
O 409 é a resposta correta a "tente de novo enquanto ainda está processando". Tentar de novo em
loop sobre um 409 não acelera nada — a ingestão já está rodando.
Relacionado
- Cadastro de imóveis — onde as imagens viajam a primeira vez
GET /properties/{paId}— para ler o blocoimagessem custo- Publicar um anúncio — o fluxo completo, e por que as imagens não impedem publicar