Despublicar de un portal

Cuando querés que el aviso deje de estar publicado en el portal, esto lo da de baja.

No borra la propiedad: sigue en tu inventario y podés volver a publicarla cuando quieras.

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

Mismo scope que publicar ({portal}:publish), mismo paId, sin 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 } }

Es idempotente: llamalo las veces que quieras

Si el aviso ya no estaba publicado, igual recibís 200 — con alreadyUnpublished: true. No es un error: el resultado que buscabas ya se cumplió.

Eso hace que reintentar sea siempre seguro, incluso después de un 502 donde no sepas si la baja llegó.

Los errores

CódigoQué pasóQué hacer
404esa propiedad no está en tu inventariorevisá el paId
409la cuenta no está conectada al portalsin conexión no podemos nombrar el aviso del otro lado
502el portal rechazó la baja, o no respondiósi no respondió, puede haberse dado de baja igual: reintentá

Dos cosas que conviene tener presentes

  • Gasta cuota. Una baja consume una llamada de las de tu cliente en el portal, igual que publicar.
  • Despublicar no borra la propiedad. Sigue en tu inventario y podés volver a publicarla cuando quieras con el mismo paId — el aviso se recrea, no se duplica.

Relacionado