Este serviço retorna os detalhes de um imóvel da sua conta (a imobiliária dona do token). O escopo vem do access token, não é enviado como parâmetro.
| Informações do recurso | |
|---|
| Autenticação | Obrigatória (Token de API, Bearer) |
| Scope | express-base |
| HTTP Method | GET |
| Response | JSON |
| Version | 1 |
https://mapaprop.app/api/action/express-v1/properties/{propertyHash}
GET /api/action/express-v1/properties/YoJEWd1x4qvlpGw HTTP/1.1
Host: mapaprop.app
Content-Type: application/x-www-form-urlencoded
Content-Length: 0
Authorization: Bearer {access_token}
| Key | Type | Required | Descrição |
|---|
| propertyHash | string | yes | O Hash ID do imóvel |
Um documento JSON com o detalhe do imóvel.
| Objeto | Campo | Tipo | Obrigatório | Descrição |
|---|
| Response | property | Property object | yes | O objeto imóvel |
| Property | propertyHash | string | yes | O ID único do imóvel |
| timestamp | string | yes | Timestamp ISO8601 de quando o imóvel foi criado |
| lastUpdate | string | yes | Timestamp ISO8601 da última atualização do imóvel |
| code | string | yes | Código único do imóvel inserido pelo cliente |
| branchId | int | yes | O ID da filial à qual o imóvel pertence. GET /api/action/express-v1/branches. |
| type | int | yes | O tipo de imóvel. GET /api/action/express-v1/types |
| propertyType | string | yes | A descrição traduzida do tipo de imóvel. GET /api/action/express-v1/types |
| operation | int | yes | O Id da operação do imóvel. Constantes |
| propertyOperation | string | yes | A descrição traduzida da operação do imóvel. Constantes |
| status | id | yes | O Id do estado de construção do imóvel. Constantes |
| mainImage | string | no | A URL da imagem principal (thumbnail) do imóvel |
| currency | string | yes | O símbolo de moeda do preço do imóvel. Constantes |
| price | int | yes | O preço do imóvel |
| expensesCurrencies | string | no | O símbolo de moeda das despesas mensais/anuais do imóvel. Constantes |
| expensesPrice | int | no | O valor das despesas mensais/anuais do imóvel |
| taxCurrency | string | no | O símbolo de moeda dos impostos mensais/anuais do imóvel. Constantes |
| taxPrice | int | no | O valor dos impostos mensais/anuais do imóvel |
| title | string | yes | Título inserido pelo cliente |
| address | string | yes | O endereço e número do imóvel |
| zipCode | string | yes | O CEP da localização do imóvel |
| zone | string | yes | Descrição amigável combinando cidade (se disponível) e estado |
| countryId | int | yes | O ID do país onde o imóvel está localizado |
| stateId | int | yes | O ID do estado onde o imóvel está localizado. GET /api/action/express-v1/zones |
| countyId | int | yes | O ID do município onde o imóvel está localizado. GET /api/action/express-v1/zones |
| cityId | int | no | O ID da cidade onde o imóvel está localizado. GET /api/action/express-v1/zones |
| countryId | int | yes | O ID do país onde o imóvel está localizado. GET /api/action/express-v1/zones |
| country | string | yes | O nome do país |
| state | string | yes | O nome do estado |
| county | string | yes | O nome do município ou segunda divisão geográfica |
| city | string | no | O nome da cidade, bairro ou terceira divisão |
| suspended | boolean | yes | A publicação foi suspensa |
| reserved | boolean | yes | O imóvel foi reservado |
| rented | boolean | yes | O imóvel foi alugado |
| sold | boolean | yes | O imóvel foi vendido |
| description | string | yes | A descrição longa do imóvel |
| conditions | string | no | As condições detalhadas do imóvel. Geralmente relacionadas a pagamentos |
| bedrooms | int | no | Número de quartos no imóvel |
| ambiences | int | no | Quantidade de ambientes do imóvel |
| bathrooms | int | no | Número de banheiros no imóvel |
| dependencies | int | no | Número de quartos de dependência (quartos extras) |
| occupancy | int | no | Quantidade de ocupantes (geralmente para aluguel temporário) |
| toilettes | int | no | Número de lavabos (banheiros incompletos) no imóvel |
| buildingArea | int | no | Metros quadrados da área construída |
| landArea | int | no | Metros quadrados do terreno do imóvel |
| yearsOld | int | no | Idade do imóvel |
| ubication | string | no | Posição cardinal do imóvel no edifício |
| totalFloors | int | no | Total de andares do edifício |
| apartmentsPerFloor | int | no | Quantidade de apartamentos por andar |
| airConditionerType | string | no | Tipo de ar-condicionado. |
| waterHeaterType | string | no | Tipo de aquecedor de água. |
| heatingType | string | no | Tipo de aquecimento. |
| balconyType | string | no | Tipo de varanda. |
| garage | int | no | Total de vagas de garagem do imóvel |
| garageType | string | no | Tipo de garagem. |
| images | Array of Image | no | Array de objetos Image |
| location | Location | yes | Objeto Location |
| Location | lon | string | yes | Longitude geográfica do imóvel |
| lat | string | yes | Latitude geográfica do imóvel |
| Image | image | string | yes | URL da imagem |
| thumbnail | string | yes | URL do thumbnail |
| orientation | int | yes | Orientação da imagem. 1 = PORTRAIT, 2 = LANDSCAPE |
| type | int | yes | Tipo de imagem. 1 = PHOTO, 2 = BLUEPRINT |
| contentType | string | yes | O content type da imagem |
| timestamp | string | yes | Timestamp ISO8601 de quando a imagem foi enviada |
| Labels | labels | Array of labels | no | Labels do imóvel - Constantes |
| attributes | attributes | Array of json attributes | no | Todos os atributos do imóvel |
| descriptionFormatted | description | string | no | Descrição com novo formato que aceita quebras de linha |
| videos | videos | Array of json | no | Vídeos do imóvel (URL ou opção embed) |
{
"code": "1-6454656",
"codeSearch": "1-6454656",
"description": "gran casa en haedo capital de ahora morona",
"alternativePrices": [],
"videos": [
{
"custId": 1,
"description": "asdasdsadadasd",
"videoId": 7252,
"source": "https://www.youtube.com/shorts/DV5mG3XGPZU",
"propertyId": 256854
},
{
"custId": 1,
"description": "asdasdsadadasd",
"videoId": 7253,
"source": "https://www.youtube.com/watch?v=gLcP6qqulhA&ab_channel=NovalProperties",
"propertyId": 256854
},
{
"custId": 1,
"description": "asdasdsadadasd",
"videoId": 7254,
"source": "<iframe width=\"560\" height=\"315\" src=\"https://www.youtube.com/embed/gLcP6qqulhA?si=CpKaYWLYZXXh4zyP\" title=\"YouTube video player\" frameborder=\"0\" allow=\"accelerometer; autoplay; clipboard-write; encrypted-media; gyroscope; picture-in-picture; web-share\" referrerpolicy=\"strict-origin-when-cross-origin\" allowfullscreen></iframe>",
"propertyId": 256854
},
{
"custId": 1,
"description": "dasdsadsss",
"videoId": 7258,
"source": "https://my.matterport.com/show?play=1&lang=en-US&m=CmhKN1eSdqR",
"propertyId": 256854
}
],
"type": 20.0,
"title": "gran casa en haedo capital de ahora morona",
"branch": {
"zip": "1416",
"zone2Description": "Cañuelas",
"branchId": 773,
"address": "Camarones 2755",
"main": true,
"zone0Description": "Argentina",
"zone3": 1074,
"zone2": 155,
"zone1": 2,
"zone0": 1,
"phone1": "4581-8985",
"zone1Description": "Buenos Aires",
"custId": 1,
"name": "Sucursal Haedo",
"zone3Description": "Máximo Paz",
"email": "info@mapaprop.com",
"customer": "Mapaprop Demo INC"
},
"customerCountry": 1.0,
"zone2Desc": "Caballito",
"customerPhone": "4581-8985",
"seoUrl": "alquiler-temporario-de-loft-en-caballito-capital-federal-1-147874",
"rented": false,
"zone": "Caballito, Capital Federal, Argentina",
"price": 54554.0,
"customerEmail": "info@mapaprop.com",
"propertyType": "Loft",
"customerId": 1.0,
"codeRaw": "6454656",
"currency": "USD",
"propertyId": 147874.0,
"timestamp": "2019-10-29T00:00:00.000-03:00",
"customerAddress": "Camarones 2755",
"branchId": 773.0,
"sold": false,
"ambiences": 5,
"images": [],
"address": "paysandu 984",
"published": true,
"zone2": 18.0,
"customerName": "Mapaprop Demo INC",
"suspended": false,
"zone1": 1.0,
"labels": [
"mortgage-ready",
"professional-available",
"furnished",
"janitor",
"grill",
"storage",
"security",
"security-box",
"swimming-pool",
"party-saloon",
"cable-included",
"telephone-line",
"daily-dinning",
"alarm",
"front-garden",
"laundry",
"patio",
"playroom",
"private-elevator",
"suite"
],
"zone0": 1.0,
"zone1Desc": "Capital Federal",
"propertyOperation": "Alquiler Temporario",
"propertyHash": "e86a6a15b7f93ae633b0b009c5c51120",
"mainImage": "noimage.gif",
"lastUpdateFormated": "29-10-2019",
"reserved": false,
"lastUpdate": "2019-10-29T14:13:54.000-03:00",
"onlyWebsite": true,
"location": {
"lon": "-58.45284939999999",
"lat": "-34.6125374"
},
"attributes": [
{
"group_sub": "label",
"country": "ar",
"key_legacy": "accessible",
"group_subtype": "ammenities",
"id": "accessible",
"label": "Accesible",
"locale": "es_AR",
"type": "bool",
"group": "propertyAttribute",
"status": true
},
],
"descriptionFormatted": "Test Images, Propiedad TestTest Images, \n\nPropiedad Test",
"operation": 3.0,
"status": 6.0,
"zone0Desc": "Argentina",
"zipCode": "1661"
}