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ódigo | Qué pasó | Qué hacer |
|---|---|---|
404 | esa propiedad no está en tu inventario | revisá el paId |
409 | la cuenta no está conectada al portal | sin conexión no podemos nombrar el aviso del otro lado |
502 | el 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
- Publicar en un portal — el
PUT, y qué pasa al volver a llamarlo - La clave
publication— qué configurar dentro del objeto