Dar baixa
São cinco operações distintas e se confundem com frequência. A diferença importa porque só uma retira o anúncio do portal: as outras quatro não o tocam.
| Você quer… | Você chama | O anúncio sai do portal? |
|---|---|---|
| baixar um anúncio de um portal | DELETE …/publication/{portal} | sim |
| baixá-lo da conta da Mapaprop do seu cliente | DELETE …/publication/mapapropapi | não — sai do site dele e das redes dele |
| desconectar a conta do seu cliente | desconectar | não |
| apagar a ficha do seu cliente | DELETE /customers | não |
| apagar um imóvel do seu inventário | DELETE /properties/{paId} | não |
⚠️ Apagar um imóvel do seu inventário também não baixa os anúncios dele: é a mesma regra das outras. Se quiser baixá-los, baixe-os antes de apagá-lo.
📌 A segunda linha se aplica somente se o seu token veio de uma conta da Mapaprop — Mapaprop.
🔴 A regra, e é uma decisão nossa, não uma limitação
Nunca damos baixa num anúncio do seu cliente por iniciativa própria. Nem ao desconectar a conta dele, nem ao apagar a ficha dele, nem se ele deixar de usar o serviço.
Esse anúncio está publicado com a conta do seu cliente no portal, e a decisão de baixá-lo é dele. Nós desconectamos o que é nosso; o anúncio dele continua sendo o anúncio dele.
O que fazemos ao desconectar é cortar o nosso próprio acesso: deixamos de poder publicar ou atualizar em nome dele.
⚠️ Isto importa para o seu desenho. Se o seu aplicativo oferece "desvincular do Mapaprop" e você supõe que isso limpa os portais, o anúncio do seu cliente vai continuar no ar — com os dados congelados do último dia em que você o atualizou. Se quiser baixá-lo, baixe-o explicitamente antes.
A ordem, se você quiser deixar tudo limpo
1 · baixar os anúncios DELETE …/publication/{portal} ← um por imóvel e portal
2 · desconectar a conta
3 · apagar a ficha (se for o caso)
Pular o passo 1 não falha: desconecta do mesmo jeito e os anúncios ficam publicados. Por isso a ordem é uma recomendação, não um requisito que o sistema imponha.
🔴 Dar baixa num empreendimento grande também pode pedir mais de uma volta
Nos portais onde cada unidade é um anúncio próprio, dar baixa no empreendimento exige desconectar cada uma antes de tocá-lo — e isso não cabe sempre numa chamada. Quando não cabe, avisamos e o anúncio continua publicado: repita a baixa e cada volta retoma de onde parou.
E continua publicado de propósito, não por uma falha: se o baixássemos com unidades ainda conectadas, o portal apagaria essas unidades. Preferimos deixá-lo no ar e que você repita.
| Repetir é seguro | as já desconectadas não são tocadas de novo |
| Nunca se perde nada | enquanto a baixa está incompleta, tudo continua como estava |
| Quando terminou | quando a resposta deixa de dizer que ficou incompleta |
Baixar um anúncio
DELETE …/publication/{portal} baixa aquele anúncio
daquele portal.
- É idempotente: se já não estava, responde bem do mesmo jeito. Você não precisa levar a conta.
- É por portal: se você publicou em três, são três chamadas. Baixar de um não mexe nos outros.
- Gasta uma chamada da cota do seu cliente, como publicar.
- O imóvel continua existindo do nosso lado: despublicar não é apagar. Você pode publicá-lo de novo quando quiser, com o mesmo identificador.
Não despublique um anúncio enquanto o portal ainda está processando a publicação dele. Se você publicou e despublicou em seguida, a baixa vai responder normalmente e o anúncio pode voltar a ficar online: o portal continua o trabalho pendente e o termina depois da baixa.
Acontece principalmente com empreendimentos grandes, onde o portal trabalha em modo diferido e a janela é de minutos. O sintoma é desconcertante: você dá baixa, vê o anúncio fora do ar por um tempo, e ele volta sozinho.
Espere até o status parar de dizer que está processando e só então dê baixa. Se você tentar publicar de novo nesse meio-tempo, vamos recusar como algo temporário — é a mesma janela.
Desconectar a conta
Desconectar corta o nosso acesso à conta do portal. Depois disso não é possível publicar nem atualizar até que o seu cliente a conecte de novo.
O que conservamos de propósito, e é o que faz com que reconectar seja barato:
- Quais imóveis estavam publicados em qual portal. Ao reconectar, o estado é recuperado e corrigido contra o que o portal diz de verdade.
- O mapeamento das zonas. Esse dado é do sistema, não da conta: não é apagado nunca.
Apagar a ficha do cliente
DELETE /customers apaga o que temos daquele cliente. Os
anúncios dele nos portais continuam publicados — mesma regra de cima.
É a operação menos reversível de todas: depois de apagar, cadastrar esse cliente outra vez é começar do zero, conexão do portal incluída.
Como cada uma responde se você se antecipar
| Se você… | |
|---|---|
| baixa um anúncio que já estava baixado | 200, sem drama. É idempotente |
| baixa um anúncio de um portal onde nunca publicou | dizemos isso, e não há nada quebrado |
| desconecta uma conta que não estava conectada | dizemos isso nomeando o portal |
| publica depois de desconectar | o erro diz que falta conectar essa conta, não "você não tem permissão" |
Relacionado
- Despublicar de um portal — o endpoint e o contrato dele
- Consultar e desconectar · Dar baixa num cliente
- Cadastrar um cliente — o caminho inverso