GET /cabaprop/get-branches
Dado o token do Cabaprop obtido em POST /cabaprop/connect, este serviço devolve o perfil da imobiliária no Cabaprop e suas filiais. O id do perfil (real estate id) e o id de uma filial (branch office id) são obrigatórios para publicar anúncios com POST /cabaprop/publish.
| Informações do recurso | |
|---|---|
| Autenticação | Obrigatória (token do Mapaprop + token do Cabaprop) |
| Método HTTP | GET |
| Resposta | JSON |
| Versão | 1 |
Resource URL
https://property-api.mapaprop.com/cabaprop/get-branches
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 |
Response
Em caso de sucesso devolve um 200 com o perfil bruto da imobiliária, exatamente como o Cabaprop o entrega:
{
"id": "81592",
"name": "Mi Inmobiliaria",
"email": "contacto@miinmobiliaria.com.ar",
"branchOffices": [
{
"id": "83347",
"branch_office_name": "Casa Central"
}
],
"socialNetworks": {}
}
| Campo | Tipo | Descrição |
|---|---|---|
id | string | Id da imobiliária no Cabaprop (real_estate_id, obrigatório para publicar). |
name | string | Nome da imobiliária. |
email | string | E-mail de contato registrado no Cabaprop. |
branchOffices | array | Filiais da imobiliária. Cada uma tem id (branch_office_id, obrigatório para publicar) e branch_office_name. |
socialNetworks | object | Redes sociais cadastradas no perfil do Cabaprop. |
Se branchOffices vier vazio, a imobiliária não tem filiais cadastradas no Cabaprop e a publicação pode falhar — é necessário cadastrar pelo menos uma filial no painel do Cabaprop.
Erros
| Status | Corpo | Causa |
|---|---|---|
| 400 | {"error":"X-Cabaprop-Token header is required"} | Falta o header X-Cabaprop-Token. |
| 401 | {"error":"Cabaprop authentication failed"} | O token do Cabaprop é inválido ou expirou. Chame novamente POST /cabaprop/connect. |
| 500 | {"error":"Error fetching Cabaprop branches","detail":"..."} | Erro inesperado ao contatar o Cabaprop. |