DELETE /cabaprop/property/unpublish
Despublica (baixa lógica) um anúncio publicado anteriormente com POST /cabaprop/publish.
É idempotente: se o imóvel nunca foi publicado, ou já estava despublicado, ou o Cabaprop responde que o anúncio não existe mais, este endpoint mesmo assim devolve sucesso.
| Informações do recurso | |
|---|---|
| Autenticação | Obrigatória (token do Mapaprop + token do Cabaprop) |
| Método HTTP | DELETE |
| Resposta | JSON |
| Versão | 1 |
Resource URL
https://property-api.mapaprop.com/cabaprop/property/unpublish
Headers
| Header | Obrigatório | Descrição |
|---|---|---|
Authorization | sim | Bearer <token> — token do Mapaprop |
X-Cabaprop-Token | sim | Token do Cabaprop obtido em POST /cabaprop/connect |
Content-Type | sim | application/json |
Parameters (body request)
| Key | Tipo | Obrigatório | Descrição |
|---|---|---|---|
propertyId | number/string | sim | Id do imóvel publicado. |
custId | number/string | sim | Id do cliente/conta, deve coincidir com a conta autenticada. |
Sample code
DELETE /cabaprop/property/unpublish
Host: property-api.mapaprop.com
Content-Type: application/json
Authorization: Bearer {access_token}
X-Cabaprop-Token: {cabaprop_token}
{
"propertyId": 188017,
"custId": 1
}
Response
{
"success": true
}
Erros
| Status | Corpo | Causa |
|---|---|---|
| 400 | {"error":"Invalid JSON body"} | O body não é um JSON válido. |
| 403 | {"error":"custId does not match the authenticated customer"} | O custId do body não coincide com a conta autenticada. |
| 400 | {"error":"propertyId and custId are required"} | Falta algum dos campos obrigatórios. |
| 400 | {"error":"Cabaprop account is not connected (missing token)"} | Falta o token do Cabaprop (somente se o imóvel tiver um anúncio ativo a despublicar). |
| 401 | {"error":"Cabaprop authentication failed — reconnect the account"} | O token do Cabaprop é inválido ou expirou. |
| 200 | {"success":false,"errorCode":"...","detail":"..."} | O Cabaprop rejeitou a despublicação por dados inválidos. detail traz a mensagem textual do portal. |
| 500 | {"error":"Error unpublishing Cabaprop property","detail":"..."} | Erro inesperado. |