Estes 4 endpoints (get-zone/get-operation/get-type/get-attribute) são do Cabaprop v1, a versão atualmente em produção. O Cabaprop v2 (ainda em teste, com o cutover pendente) resolve zona/tipo/operação de outra forma: um crosswalk estático próprio + GET /api/v2/catalogs — não usa estes 4 endpoints. Se você está integrando contra a v2, esta página não se aplica.
Estes 4 endpoints consultam um mapeamento já existente entre um identificador próprio do Mapaprop e seu equivalente no Cabaprop (zona, operação, tipo/subtipo e atributo).
Diferentemente de Zonaprop API > Mapping zone, não existe um método para criar mapeamentos novos. Os mapeamentos de zona vêm pré-carregados com o esquema próprio do Mapaprop (zone0-zone1-zone2-0, com zone2 = bairro de CABA), por isso estes 4 endpoints só são úteis se a sua aplicação já conhece esses ids. Para a maioria das integrações recomendamos usar diretamente os Cabaprop API > Catálogos de localização (bairros, tipos de operação, tipos/subtipos, atributos) para resolver os ids do Property Object sem depender deste mapeamento. Se você precisar que criemos um mapeamento novo, escreva para dev@mapaprop.com.
Headers (para os 4 endpoints)
| Header | Obrigatório | Descrição |
|---|---|---|
Authorization | sim | Bearer <token> — token do Mapaprop |
| Informações do recurso | |
|---|---|
| Autenticação | Obrigatória (token do Mapaprop) |
| Método HTTP | GET |
| Resposta | JSON |
| Versão | 1 |
Mapeamento de zona (GET)
Resource URL
https://property-api.mapaprop.com/cabaprop/get-zone
Parameters - URL
| Key | Tipo | Obrigatório | Descrição |
|---|---|---|---|
brandZoneId | string | sim | Id da zona, com o esquema zone0-zone1-zone2-0 (zone3 sempre "0"). |
Response
Se não houver mapeamento salvo, responde 200 com {}. Se houver:
{
"cz_brand_zone_id": "1-2-2-0",
"cz_brand": "mapaprop",
"cz_cabaprop_zone_id": "1234",
"cz_cabaprop_zone_name": "Palermo"
}
cz_cabaprop_zone_id pode vir como um único id ("1234") ou como uma lista separada por vírgulas ("1234,5678") quando a zona corresponde a vários bairros limítrofes do Cabaprop.
Mapeamento de operação (GET)
Resource URL
https://property-api.mapaprop.com/cabaprop/get-operation
Parameters - URL
| Key | Tipo | Obrigatório | Descrição |
|---|---|---|---|
brandOperationId | string | sim | Id da operação na sua aplicação. |
Response
Se não houver mapeamento salvo, responde 200 com {}. Se houver:
{
"cz_brand_operation_id": "1",
"cz_brand": "mapaprop",
"cz_cabaprop_operation_id": "1"
}
Mapeamento de tipo / subtipo (GET)
Resource URL
https://property-api.mapaprop.com/cabaprop/get-type
Parameters - URL
| Key | Tipo | Obrigatório | Descrição |
|---|---|---|---|
brandTypeId | string | sim | Id do tipo de imóvel na sua aplicação. |
Response
Se não houver mapeamento salvo, responde 200 com {}. Se houver:
{
"cz_brand_type_id": "2",
"cz_brand": "mapaprop",
"cz_cabaprop_type_id": "3",
"cz_cabaprop_sub_type_id": "12"
}
Mapeamento de atributo (GET)
Resource URL
https://property-api.mapaprop.com/cabaprop/get-attribute
Parameters - URL
| Key | Tipo | Obrigatório | Descrição |
|---|---|---|---|
attributeId | string | sim | Id do atributo na sua aplicação. |
Response
Se não houver mapeamento salvo, responde 200 com {}. Se houver:
{
"cz_brand_attribute_id": "5",
"cz_brand": "mapaprop",
"cz_cabaprop_attribute_id": "9",
"cz_cabaprop_attribute_name": "Parrilla"
}
Erros (para os 4 endpoints)
| Status | Corpo | Causa |
|---|---|---|
| 400 | {"error":"brandZoneId is required"} (ou brandOperationId/brandTypeId/attributeId, conforme o endpoint) | Falta o parâmetro obrigatório. |
| 500 | {"error":"Error querying Cabaprop <mapeo>","detail":"..."} | Erro inesperado na consulta. |