Mapaprop

Despublicar de um portal

Quando você quer que o anúncio deixe de estar publicado no portal, isto o retira.

Não apaga o imóvel: ele continua no seu inventário e você pode publicá-lo de novo quando quiser.

DELETE /property-v1/properties/{paId}/publication/{portal}

Mesmo escopo que publicar ({portal}:publish), mesmo paId, sem body.

curl -X DELETE "https://property-api.mapaprop.com/property-v1/properties/01M3Z4MF6S817S9V8QADXFFXN3/publication/zonapropapi" \
  -H "Authorization: Bearer $TOKEN" \
  -H "x-client-ref: $CLIENT_REF"

{ "status": "unpublished",
  "portal": "zonapropapi",
  "paId": "01M3Z4MF6S817S9V8QADXFFXN3",
  "alreadyUnpublished": false,
  "quota": { "remaining": 1479, "limit": 1500 } }

É idempotente: chame quantas vezes quiser

Se o anúncio já não estava publicado, você recebe 200 do mesmo jeito — com alreadyUnpublished: true. Não é um erro: o resultado que você queria já estava cumprido.

Isso faz com que tentar de novo seja sempre seguro, inclusive depois de um 502 em que você não sabe se a baixa chegou.

Os erros

CódigoO que aconteceuO que fazer
404essa propriedade não está no seu inventárioconfira o paId
409a conta não está conectada ao portalsem conexão não podemos nomear o anúncio do lado de lá
502o portal recusou a baixa, ou não respondeuse não respondeu, pode ter sido retirado mesmo assim: tente de novo

Duas coisas que convém ter em mente

  • Consome cota. Uma baixa usa uma das chamadas do seu cliente no portal, igual a publicar.
  • Despublicar não apaga a propriedade. Ela continua no seu inventário e você pode publicá-la de novo quando quiser com o mesmo paId — o anúncio é recriado, não duplicado.

Relacionado